SkynestSkynest

FAQ

Prerequisites and setup instructions for connecting your AI tool to Skynest.

Prerequisites

  • GitHub account — Skynest uses GitHub OAuth for authentication. You'll be prompted to authorize during the first connection.
  • Vault access — Ask your Skynest admin to add your GitHub username as a collaborator on the vault repository.

Claude Code CLI

Run the following command in your terminal to register the Skynest MCP server:

claude mcp add --transport http skynest https://YOUR_SKYNEST_URL/api/mcp

After adding, restart Claude Code and you'll be prompted to sign in with GitHub on first use.

Manual config alternative

Add the following to your ~/.claude/mcp.json:

{
  "mcpServers": {
    "skynest": {
      "type": "http",
      "url": "https://YOUR_SKYNEST_URL/api/mcp"
    }
  }
}

Claude Code App (Desktop)

  1. Open Claude Code and go to Settings.
  2. Navigate to MCP Servers and click Add Server.
  3. Enter the following details:
    Name:      skynest
    Transport: HTTP
    URL:       https://YOUR_SKYNEST_URL/api/mcp
  4. Save and restart. You'll be prompted to sign in with GitHub on first use.

Cursor

Add the following to your project's .cursor/mcp.json (or the global Cursor MCP config):

{
  "mcpServers": {
    "skynest": {
      "url": "https://YOUR_SKYNEST_URL/api/mcp",
      "transport": "http"
    }
  }
}

Reload Cursor. On first use, a browser window will open for GitHub OAuth sign-in.

Common questions

I'm getting an authentication error. What do I do?

Make sure you've been added as a collaborator on the vault repository by your admin. If you're already a collaborator, try disconnecting and reconnecting the MCP server to trigger a fresh OAuth flow.

Can I use Skynest with other MCP-compatible tools?

Yes. Skynest exposes a standard MCP HTTP endpoint. Any tool that supports MCP over HTTP with OAuth 2.1 should work. Use the server URL https://YOUR_SKYNEST_URL/api/mcp as the endpoint.