Connect your AI client to aicharged.io
Every recipe below talks to the same MCP endpoint. Pick your client — or install the CLI and let it find and configure every agent on this machine.
Connect in one line
- Install the CLI · macOS / Linux
-
curl -fsSL https://aicharged.io/install.sh | sh && aicharged setup - Install the CLI · Windows
-
irm https://aicharged.io/install.ps1 | iex; aicharged setup - MCP endpoint
-
https://aicharged.io/api/v1/mcpStreamable HTTP. Send the header Authorization: Bearer <API_KEY>, or sign in with OAuth where your client supports it.
- Or tell your agent
-
Read https://aicharged.io/agent.md and set me up with aicharged.io
Open with this prompt in Claude (opens in a new tab) ChatGPT (opens in a new tab) Perplexity (opens in a new tab)
Every client, step by step
Terminal agents (CLI)
- Claude Code Pre-selected One command adds aicharged.io as a remote MCP server (HTTP) to Claude Code — for this project or for all of them. API key (Bearer) OAuth sign-in Local bridge (stdio)
- Codex The Codex CLI, desktop app and IDE extension share one config; the key is read from an environment variable. API key (Bearer) OAuth sign-in
- Gemini CLI Gemini CLI connects over Streamable HTTP (httpUrl) with an Authorization header. API key (Bearer) OAuth sign-in
- Antigravity Antigravity (IDE, CLI and app) uses the serverUrl key in mcp_config.json. API key (Bearer) OAuth sign-in
- GitHub Copilot CLI GitHub Copilot CLI adds aicharged.io with one command; the config lands in ~/.copilot/mcp-config.json. API key (Bearer)
- OpenCode OpenCode: a remote MCP server in opencode.json, with the key read from an environment variable. API key (Bearer) OAuth sign-in
- Amp Amp: add aicharged.io to amp.mcpServers in settings.json with the key from an environment variable — or sign in with OAuth via amp mcp add. API key (Bearer) OAuth sign-in
- Goose Goose: a one-click goose:// link, or a streamable_http extension in config.yaml (the key is uri, not url). API key (Bearer) OAuth sign-in
- Qwen Code Qwen Code adds aicharged.io with one command; the config uses httpUrl (Streamable HTTP) with an Authorization header. API key (Bearer) OAuth sign-in
- Grok Build Grok Build, the xAI coding agent, adds aicharged.io with grok mcp add, or through ~/.grok/config.toml with the key from an environment variable. API key (Bearer) OAuth sign-in
- Pi Pi has MCP built in: one command with the key from an environment variable, or ~/.pi/agent/mcp.json. API key (Bearer) OAuth sign-in
- Mistral Vibe Mistral Vibe CLI: vibe mcp add reads the key from an environment variable; or append the server to config.toml. API key (Bearer) OAuth sign-in
Editors & IDEs
- Cursor Add aicharged.io to Cursor with one click (deeplink) or by editing mcp.json. API key (Bearer) OAuth sign-in
- VS Code VS Code with GitHub Copilot: install link, code --add-mcp, or a .vscode/mcp.json that prompts for the key securely. API key (Bearer) OAuth sign-in
- Windsurf (Devin Desktop) Windsurf is now Devin Desktop: its Cascade agent reads mcp_config.json with serverUrl — mind the limit of 100 tools. API key (Bearer) OAuth sign-in
- JetBrains AI Assistant / Junie JetBrains IDEs (AI Assistant, Junie): paste a JSON server definition in Settings → Tools → AI Assistant → MCP. AI Assistant has no OAuth — use the API key. API key (Bearer)
- Cline Cline (VS Code extension and CLI): a streamableHttp server in cline_mcp_settings.json. API key (Bearer) OAuth sign-in
- Zed Zed: a context server with url and headers in settings.json — without the header Zed offers an OAuth sign-in. API key (Bearer) OAuth sign-in
- Roo Code Roo Code: a streamable-http server in .roo/mcp.json (project) or in the global MCP settings. API key (Bearer)
- Kilo Code Kilo Code: a remote server under mcp in kilo.jsonc, with the key in a header. API key (Bearer) OAuth sign-in
- Warp Warp: Settings → Agents → MCP servers → + Add, then paste the JSON. API key (Bearer) OAuth sign-in
- Kiro Kiro: ~/.kiro/settings/mcp.json with the key from an environment variable that you approve in the Kiro settings. API key (Bearer) OAuth sign-in
- Trae Trae: add the server manually in the MCP panel or in .trae/mcp.json (format not fully verified). API key (Bearer)
- Raycast Raycast (Pro): the Install MCP Server command takes the URL and an Authorization header. API key (Bearer) OAuth sign-in
AI assistants
- Claude.ai Claude.ai on the web and on mobile: a custom connector with the server URL and an API-key request header. API key (Bearer) OAuth sign-in
- Claude Desktop Claude Desktop: the same custom connector as on the web, or claude_desktop_config.json through the aicharged CLI (stdio). API key (Bearer) OAuth sign-in Local bridge (stdio)
- ChatGPT ChatGPT accepts custom MCP servers only with OAuth sign-in (plugins) — it cannot send a static API key. OAuth sign-in
- GitHub Copilot coding agent GitHub Copilot coding agent in a repository: MCP configuration in the repo settings and the key as an agent secret. API key (Bearer)
- Perplexity Perplexity (Pro, Max, Enterprise): a custom remote connector with your API key (steps not fully verified). API key (Bearer) OAuth sign-in
- Mistral Le Chat Mistral Le Chat: an administrator adds a Custom MCP Connector; Le Chat detects the Bearer-token sign-in by itself. API key (Bearer) OAuth sign-in
- Grok Grok on grok.com: a custom connector — the API-key option is unverified; on the xAI API a remote MCP tool works with your key today. API key (Bearer) OAuth sign-in
- Microsoft Copilot Studio Microsoft Copilot Studio: add aicharged.io as a Model Context Protocol tool with API-key authentication in the Authorization header. API key (Bearer) OAuth sign-in
SDKs & frameworks
- Python (MCP SDK) The official Python MCP SDK (v1): a Streamable HTTP client with an Authorization header. API key (Bearer)
- TypeScript (MCP SDK) The official TypeScript MCP SDK (2.3.0 or newer) with the StreamableHTTPClientTransport. API key (Bearer)
- OpenAI Agents SDK (Python) OpenAI Agents SDK for Python: MCPServerStreamableHttp with an Authorization header, passed to the agent in mcp_servers. API key (Bearer)
- OpenAI Responses API OpenAI Responses API: a hosted mcp tool — OpenAI calls aicharged.io for you; the key goes into the authorization field. API key (Bearer)
- Anthropic Messages API Anthropic Messages API MCP connector (beta): mcp_servers plus an mcp_toolset — Claude calls aicharged.io straight from the API. API key (Bearer)
- Vercel AI SDK Vercel AI SDK: createMCPClient from @ai-sdk/mcp with an HTTP transport; pass the tools straight to generateText or streamText. API key (Bearer) OAuth sign-in
- LangChain LangChain: langchain[mcp] turns the aicharged.io tools into LangChain tools through MCPAdapter. API key (Bearer)
- LlamaIndex LlamaIndex: BasicMCPClient with headers, then McpToolSpec turns the tools into LlamaIndex tools. API key (Bearer) OAuth sign-in
- Mastra Mastra: MCPClient from @mastra/mcp with the key in the requestInit headers. API key (Bearer) OAuth sign-in
- CrewAI CrewAI: give the agent an MCPServerHTTP in mcps, with streamable HTTP and an Authorization header. API key (Bearer)
- Pydantic AI Pydantic AI: an MCPToolset with the API key as auth, added to the agent toolsets. API key (Bearer) OAuth sign-in
- AutoGen AutoGen: StreamableHttpServerParams with headers, used through McpWorkbench. API key (Bearer)
- smolagents Hugging Face smolagents: MCPClient over streamable-http; its docs do not show the headers key. API key (Bearer)
Automation
- n8n n8n: the MCP Client Tool of an AI Agent node, with Bearer Auth credentials. API key (Bearer) OAuth sign-in
- Zapier Zapier: the MCP Client action (beta) with Streamable HTTP and a Bearer token. API key (Bearer) OAuth sign-in
- Make Make: the MCP Client app (open beta) with your API key as the access token. API key (Bearer) OAuth sign-in
- Dify Dify: an HTTP MCP server under Tools → MCP with a custom Authorization header. API key (Bearer) OAuth sign-in
- Flowise Flowise: the Custom MCP tool with a JSON config; the key can live in a Flowise variable. API key (Bearer)