Developer tools

Editors and command-line agents use the same server as Claude and ChatGPT. Add the URL to your client’s MCP settings, then sign in once in the browser.

Server URL: https://app.fanaura.com/mcp Transport: Streamable HTTP Sign-in: OAuth 2.1 with PKCE and dynamic client registration. Desktop apps may use a loopback redirect. No API key, no client ID to paste.

Add the server

Add this to .cursor/mcp.json in your project, or to ~/.cursor/mcp.json for every project.

.cursor/mcp.json

{
  "mcpServers": {
    "fanaura": {
      "url": "https://app.fanaura.com/mcp"
    }
  }
}

Open Cursor Settings, then MCP. Fanaura shows Needs login. Click it, sign in on the Fanaura page, and tap Allow access. Cursor returns you to the editor on its own.

Add this to .vscode/mcp.json. GitHub Copilot agent mode reads it.

.vscode/mcp.json

{
  "servers": {
    "fanaura": {
      "type": "http",
      "url": "https://app.fanaura.com/mcp"
    }
  }
}

Click Start above the server entry. VS Code opens the Fanaura sign-in page in your browser and finishes on 127.0.0.1 or vscode.dev.

Run this once in your terminal:

claude mcp add --transport http fanaura https://app.fanaura.com/mcp

Then start Claude Code, type /mcp, choose fanaura, and choose Authenticate. Add --scope user to the first command to use Fanaura in every project.

Add this to ~/.gemini/settings.json:

~/.gemini/settings.json

{
  "mcpServers": {
    "fanaura": {
      "httpUrl": "https://app.fanaura.com/mcp"
    }
  }
}

Start Gemini CLI and run /mcp auth fanaura to sign in.

Add this to ~/.codeium/windsurf/mcp_config.json:

mcp_config.json

{
  "mcpServers": {
    "fanaura": {
      "serverUrl": "https://app.fanaura.com/mcp"
    }
  }
}

Refresh the MCP list in Cascade and sign in when the browser opens.

Add this to ~/.codex/config.toml:

~/.codex/config.toml

[mcp_servers.fanaura]
url = "https://app.fanaura.com/mcp"

Then run codex mcp login fanaura.

Client settings formats change often. If a field name above stops working, check your client’s MCP documentation. The URL never changes.

Any other MCP client

Any client that supports remote MCP servers over Streamable HTTP with OAuth can connect. The client needs to do four things, and most do them for you:

Discover the sign-in server

Call https://app.fanaura.com/mcp without a token. Fanaura answers 401 with WWW-Authenticate: Bearer realm="fanaura-mcp". The client then reads https://app.fanaura.com/.well-known/oauth-protected-resource and https://app.fanaura.com/.well-known/oauth-authorization-server.

POST https://app.fanaura.com/api/oauth/mcp/register with its redirect URI. Fanaura returns a client ID.

Send the user to sign in

Open https://app.fanaura.com/oauth/mcp/authorize with PKCE (S256). The user signs in and taps Allow access.

Exchange the code

POST https://app.fanaura.com/api/oauth/mcp/token. Send the access token as Authorization: Bearer on every MCP request.

Full endpoint details are on the authentication page.

Allowed return addresses

Fanaura only sends a sign-in back to addresses it trusts. Desktop clients work because they return to the same computer.

Return address	Used by
`http://localhost:<port>/...`, `http://127.0.0.1:<port>/...`, `http://[::1]:<port>/...`	Cursor, VS Code, Claude Code, Gemini CLI, Codex, Windsurf
`cursor://anysphere.cursor-mcp/oauth/callback`	Cursor desktop
`https://www.cursor.com/...`	Cursor in the browser and background agents
`https://vscode.dev/redirect`	VS Code in the browser
`https://claude.ai/...`, `https://*.anthropic.com/...`	Claude
`https://chatgpt.com/...`, `https://*.openai.com/...`	ChatGPT

Any other http:// address, a custom scheme other than Cursor’s, or a URL with a username or password is refused. If your client uses a hosted callback that is not on this list, email support@fanaura.com with the exact URL.

MCP Registry

Fanaura is not listed in the official MCP Registry yet. Add https://app.fanaura.com/mcp to your client directly.

Test it from the terminal

You can confirm the server answers before you set up a client. Without a token, a 401 is the correct answer.

curl -i -X POST https://app.fanaura.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

HTTP/2 401
www-authenticate: Bearer realm="fanaura-mcp"

Overview

Connect your assistant

Guides

Tool reference

Security and data

Add the server

Any other MCP client

Allowed return addresses

MCP Registry

Test it from the terminal

​Add the server

​Any other MCP client

​Allowed return addresses

​MCP Registry

​Test it from the terminal

Add the server

Any other MCP client

Allowed return addresses

MCP Registry

Test it from the terminal