aigon.ai / docs

MCP Setup

Step-by-step setup for connecting your AI assistant to the Aigon MCP server.

Endpoint: https://mcp.aigon.ai/sse

Authentication is handled automatically via OAuth — a browser window opens for login and consent on first use.


Claude Code

Claude Code supports SSE transport natively:

claude mcp add --transport sse aigon-mcp-server https://mcp.aigon.ai/sse

Verify with /mcp — it should show aigon-mcp-server as connected.


Claude Desktop

Claude Desktop does not support SSE transport directly. Use mcp-remote as a bridge.

1. Install Node.js if you don't have it — mcp-remote requires it.

2. Add to claude_desktop_config.json:

{
  "mcpServers": {
    "aigon-mcp-server": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.aigon.ai/sse"]
    }
  }
}

File location: - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - Windows: %APPDATA%\Claude\claude_desktop_config.json

3. Restart Claude Desktop.

If Claude Desktop cannot find npx, use the absolute path to your Node.js installation:

{
  "mcpServers": {
    "aigon-mcp-server": {
      "command": "/path/to/npx",
      "args": ["mcp-remote", "https://mcp.aigon.ai/sse"],
      "env": {
        "PATH": "/path/to/node:/usr/local/bin:/usr/bin:/bin"
      }
    }
  }
}

Find your npx path with which npx in your terminal.


Cursor

Add to .cursor/mcp.json in your project root, or ~/.cursor/mcp.json for global access:

{
  "mcpServers": {
    "aigon-mcp-server": {
      "url": "https://mcp.aigon.ai/sse"
    }
  }
}

Cursor supports SSE transport and OAuth natively.


Gemini CLI

Add to ~/.gemini/settings.json:

{
  "mcpServers": {
    "aigon-mcp-server": {
      "url": "https://mcp.aigon.ai/sse"
    }
  }
}

ChatGPT

ChatGPT supports remote MCP servers for Pro, Team, and Enterprise users:

  1. Go to Settings → Apps & Connectors
  2. Enable Developer Mode
  3. Click Add connector
  4. Enter the server URL: https://mcp.aigon.ai/sse
  5. Select OAuth for authentication
  6. Click I trust this application

Once added, enable it in a chat via the + icon → Developer ModeAdd sources.


Other Clients

Any client that supports SSE transport can connect to:

https://mcp.aigon.ai/sse

The server advertises OAuth metadata at /.well-known/oauth-protected-resource. Clients that support OAuth 2.1 will handle authentication automatically. See Authentication for the full flow.


Troubleshooting

Browser doesn't open for login The OAuth flow requires a browser. Make sure your MCP client supports OAuth 2.1 with PKCE, or use mcp-remote which handles it.

"aigon-mcp-server" not showing as connected Check that the endpoint URL is exactly https://mcp.aigon.ai/sse (with /sse at the end).

Claude Desktop: "npx not found" Claude Desktop runs in a sandboxed environment and may not see your shell PATH. Use the absolute path to npx as shown above.