Connect a client

Every client uses the same URL and signs in the same way: in your browser, through Funnel One’s consent page. You never paste a key into an AI client.

https://app.funnelone.ai/mcp

Before you start, a workspace admin must turn on the MCP server for your workspace. It is off by default.

Let your agent do it

Paste this into Claude Code, Codex, Cursor or another AI coding agent. It fetches our setup instructions, changes its own MCP settings and then asks you to sign in. The instructions tell the agent never to ask for or use a key.

Set it up with your AI agentPaste this into Claude Code, Codex, Cursor or any AI coding agent. It connects the agent's own app to Funnel One. You sign in yourself; the agent never sees a password or key.Fetch and follow the instructions to connect me to Funnel One from https://dev.funnelone.ai/agent-setup/prompt.md

Copy promptOr follow a step-by-step guide for your agent

Or pick your client below.

Claude (claude.ai and Claude Desktop)

1. Open Customize, then Connectors. Choose +, then Add custom connector.
2. Name it Funnel One and paste https://app.funnelone.ai/mcp. Leave the OAuth client ID and secret under Advanced settings empty.
3. Choose Add, then connect it and sign in to Funnel One.

On a Team or Enterprise plan an owner may need to add the connector first, under Organization settings, then Connectors. Claude connects from Anthropic’s servers, so the connector works the same on the web, the desktop app and mobile.

Claude Code

claude mcp add --transport http funnelone https://app.funnelone.ai/mcp

Then type /mcp in Claude Code, pick funnelone and sign in in your browser. Add --scope user to use it in every project, or --scope project to share it with your team through .mcp.json. Without a local browser, run claude mcp login funnelone --no-browser.

ChatGPT

1. In ChatGPT’s settings, open Security and login and turn on Developer mode. It is available on Plus, Pro, Business, Enterprise and Education plans, on the web.
2. Create an app for a remote MCP server. Use https://app.funnelone.ai/mcp and choose OAuth for authentication.
3. Sign in to Funnel One when ChatGPT asks.

ChatGPT may ask you to confirm before a tool runs. That is ChatGPT’s own check; Funnel One’s permission checks apply either way.

Cursor

Add the server to ~/.cursor/mcp.json (every project) or .cursor/mcp.json (this project):

{
  "mcpServers": {
    "funnelone": {
      "url": "https://app.funnelone.ai/mcp"
    }
  }
}

Then open Cursor’s MCP settings and sign in when Cursor asks. The desktop app signs in through localhost, so the consent page shows it as Unverified and Loopback. That is expected.

VS Code with GitHub Copilot

Add the server to .vscode/mcp.json in your workspace, or to your user configuration with the command MCP: Open User Configuration:

{
  "servers": {
    "funnelone": {
      "type": "http",
      "url": "https://app.funnelone.ai/mcp"
    }
  }
}

Start the server from the MCP view and sign in when VS Code asks. The consent page shows VS Code as Unverified, because Funnel One does not recognize it by name yet.

Codex

codex mcp add funnelone --url https://app.funnelone.ai/mcp
codex mcp login funnelone

Or add it to ~/.codex/config.toml and then run codex mcp login funnelone:

[mcp_servers.funnelone]
url = "https://app.funnelone.ai/mcp"

Any other MCP client

Setting	Value
URL	https://app.funnelone.ai/mcp
Transport	Streamable HTTP
Authentication	OAuth 2.1 with PKCE, discovered from the server’s 401
Client registration	A client metadata document, or dynamic registration (public client, no secret)
Redirect	An https:// address, or http://localhost / http://127.0.0.1 on any port

Custom URL schemes (such as myapp://callback) are not accepted as redirects.

Agent SDKs and the Anthropic API

Coming soon. The OpenAI Agents SDK, the Anthropic API’s MCP connector and other code that cannot open a browser need a token they can send in a header. That comes with personal tokens. Until then, connect through one of the apps above.

Troubleshooting

You see	Because
403 mcp_disabled, or the consent page says MCP is off	An admin has not turned on the MCP server for this workspace.
The client connects but lists no tools	Every tool needs agent.use plus its own scope, such as companies.view. Your role does not have it, or it was not allowed at consent.
The consent page says a permission is “Not in your role”	You cannot grant what your role does not have. Ask an admin.
The app is labeled Unverified	Funnel One does not recognize that app by name. Check the address it will send you back to before you allow it.
Claude’s sign-in never finishes	Your network may block Claude’s servers from reaching Funnel One. Ask your IT team.