What you need before you connect an MCP server<\/h2>\n
Three things decide how the connection goes, so check them first.<\/p>\n
The server’s URL.<\/strong> A remote MCP server is a single HTTPS address, for example How the server authenticates.<\/strong> Modern remote servers use OAuth 2.1<\/strong>. The client opens a sign-in page in your browser, you log in to the service as yourself, approve what the assistant may access, and the client stores a token. You never copy an API key into a chat app. Older or simpler servers use a static API key sent as a header, which clients such as Claude Code and Cursor also support.<\/p>\n Your plan on the client side.<\/strong> Custom connectors are a paid feature in most consumer assistants. Claude needs a paid plan for connectors, ChatGPT allows full read-and-write custom connectors on Business and Enterprise plans while Pro connects read-only, and on Grok Business and Enterprise a team admin provisions the connector before members can use it. Coding tools such as Claude Code, Cursor, VS Code and Gemini CLI read MCP servers on any plan that includes the tool.<\/p>\n Most confusion comes from the two kinds of MCP server that look the same in a config file.<\/p>\n A remote server<\/strong> is hosted by the company whose data you want to use. ChatMaxima runs its own, so do GitHub, Notion, Stripe and others. You connect to it over HTTPS, and the company handles sign-in, scaling and updates. This is what chat apps like Claude, ChatGPT and Grok support, and it is what this guide is about.<\/p>\n A local server<\/strong> is a program that runs on your laptop and talks to the client over its standard input and output. Developers use these for filesystem access, local databases or a browser they control. Chat apps cannot reach a local server, which is why ChatGPT and Grok ask for a public URL and nothing else.<\/p>\n If a guide tells you to run Whatever client you use, connecting a remote MCP server comes down to the same sequence:<\/p>\n Once those three are done, you use the server by asking for things in plain language. The assistant calls the server’s tools on its own when the request needs them.<\/p>\n Claude calls MCP servers connectors<\/strong>. The built-in ones (Google Drive, Slack and so on) and custom ones you add yourself sit in the same place.<\/p>\n To remove it later, go back to Connectors and disconnect. On Team and Enterprise plans an Owner adds the connector for the organization, and each member signs in with their own account, so permissions stay personal.<\/p>\n The docs site has the same walkthrough with screenshots for each client.<\/p>\n Claude Code, Anthropic’s terminal coding agent, takes the URL as a command and handles OAuth itself.<\/p>\n The Then sign in from inside a session:<\/p>\n A few commands worth knowing: Claude Code also reads plugins<\/strong>, bundles of skills and MCP references. ChatMaxima publishes one that pairs the server with workflow skills (build a bot, fix a bot, write a template), so the agent follows a tested sequence rather than guessing from tool names.<\/p>\n OpenAI has two products that can use MCP, and they are set up differently.<\/p>\n ChatGPT supports custom connectors on its web app.<\/p>\n The plan matters here more than anywhere else. ChatGPT Pro can connect a custom MCP server but only use tools that read; creating or changing anything needs a Business or Enterprise workspace. That is a ChatGPT rule, not a server rule.<\/p>\n Codex, OpenAI’s coding agent, reads servers from Restart Codex, finish the sign-in when the browser opens, and ask it to do something that needs the server. Newer Codex builds can point at a remote HTTP server directly; check your version’s documentation before adding the bridge.<\/p>\n Cursor reads MCP servers from a JSON file, and it also supports one-click install links.<\/p>\n The file can be global or per project:<\/p>\n Add the server entry:<\/p>\n Save the file. Cursor picks it up without a restart. Then open Customize<\/strong> in the sidebar, find the server, and click to sign in. Cursor registers itself with the server automatically, runs the OAuth flow in your browser, and lists the tools once you approve.<\/p>\n Cursor asks before each MCP tool runs by default, with the arguments shown under the tool name, which is a sensible setting to keep when a tool can change real data.<\/p>\n Some servers also offer an Add to Cursor<\/strong> link. It is the same JSON entry encoded into a VS Code’s Copilot chat gained a guided flow for MCP servers, so you no longer need to hand-edit JSON unless you want to.<\/p>\n To check it works, send a prompt that names the server and expand the tool call in the chat to confirm which server answered it. VS Code lets you switch individual tools on and off from the Tools view, which is useful on a server with dozens of tools.<\/p>\n Google’s Gemini CLI, the terminal agent, supports remote HTTP servers and OAuth. Two options:<\/p>\n Install an extension.<\/strong> If the server’s publisher ships a Gemini CLI extension, one command adds the server, a context file with working rules, and any bundled skills:<\/p>\n Or add the server directly:<\/strong><\/p>\n Either way, sign in from inside the CLI with The Gemini CLI is the supported path for Gemini today. Google’s consumer Gemini app connects to a curated set of apps rather than custom MCP URLs, and Gemini Enterprise has its own connector form for administrators.<\/p>\n xAI added custom MCP connectors to Grok in 2026, so Grok can use any public MCP server, not only the ones in its catalog.<\/p>\n That is the whole setup. There is no per-chat toggle: Grok uses the connector’s tools whenever your question relates to that service. On Business and Enterprise plans, a team admin provisions the connector in xAI’s console first, after which each member signs in with their own account.<\/p>\n One requirement to remember from xAI’s own documentation: the server must be reachable over the public internet. A server running on your laptop needs a tunnel; a hosted server like ChatMaxima’s needs nothing extra.<\/p>\n Grok Build, xAI’s terminal coding agent, follows the same pattern as Claude Code:<\/p>\n It opens the browser for OAuth on first use, or you can trigger sign-in yourself: run The connection is done when the tool list is populated. The fastest way to prove it works is a read-only request first, then a small write.<\/p>\n With ChatMaxima connected, these three prompts cover both:<\/p>\n Each of those turns into a chain of tool calls the assistant makes on its own, and each client shows you the calls as they happen. For a longer tour of what the server can do, see Introducing ChatMaxima MCP<\/a>, and if you run an agency, Claude MCP and ChatGPT MCP for agencies<\/a> covers connecting one assistant to many client workspaces.<\/p>\n A good MCP server limits what a connected assistant can do to what you could do yourself. When you sign in to ChatMaxima from any client, the connection is bound to the workspace you pick and to your own role in it. An agent in a support role cannot delete a bot, because you cannot either. Tools that change data are marked destructive so the client can ask before running them, and two actions, submitting a WhatsApp template to Meta and adding a column to your own spreadsheet, require an explicit confirmation in the conversation before the server will act.<\/p>\n You can see every app connected to a workspace, and revoke any of them, from Settings<\/strong> then Connected Apps<\/strong> in the dashboard. Revoking stops the connection immediately, whatever the client still believes.<\/p>\n Most failures fall into a handful of causes.<\/p>\n The client says it cannot reach the server.<\/strong> Check the URL character by character. Sign-in opens but the client never shows as connected.<\/strong> You closed the browser before the last step. Finish the whole flow: sign in, choose the workspace, and click Approve. The client is waiting for the redirect back. In Claude Code and Gemini CLI, run the authenticate command again; in Cursor, click sign in again from Customize.<\/p>\n A pop-up blocker ate the sign-in window.<\/strong> Common in Claude on the web and ChatGPT. Allow pop-ups for the site and retry.<\/p>\n 401 or “needs authentication” after it used to work.<\/strong> The token expired or was revoked. Clients refresh tokens on their own, but a revoke from the server side (for example from Connected Apps) needs a fresh sign-in. Sign out and in again.<\/p>\n The server is connected but shows no tools.<\/strong> Your account’s role on the server does not include anything the assistant can use, or you approved the wrong workspace. Disconnect, reconnect, and pick the right workspace. Tool lists also refresh on reconnect, so this fixes stale lists after a server update.<\/p>\n ChatGPT connected but refuses to make changes.<\/strong> That is the plan rule: Pro is read-only for custom connectors. Use a Business or Enterprise workspace, or do the write steps from Claude or a coding tool.<\/p>\n Cursor’s internal browser cannot load the sign-in page.<\/strong> Copy the address it shows into your normal browser and finish there.<\/p>\n Two config files define the same server.<\/strong> In Cursor and VS Code, a project file and a global file with the same server name confuse the client. Keep one.<\/p>\n Connecting an assistant to a system that holds customer data deserves a minute of thought.<\/p>\n The protocol itself is open and documented at modelcontextprotocol.io<\/a>, including the authorization specification that OAuth-based servers follow, if you want to understand what the client is doing behind the sign-in page.<\/p>\n Connecting an MCP server is a five-minute job in every client once you know where the setting lives: a URL, a sign-in, and a check that the tools loaded. After that the assistant you already pay for becomes a hands-on operator of the service behind the server.<\/p>\n If the service you want to connect is ChatMaxima, every plan includes the MCP server, and the per-client guides on the ChatMaxima MCP docs<\/a> keep the exact menu names current as the clients change. Pick a plan on the pricing page<\/a>, connect the assistant you use most, and ask it to build your first bot.<\/p>\n","protected":false},"excerpt":{"rendered":" Connect an MCP server to Claude, Claude Code, ChatGPT, Codex, Cursor, VS Code, Gemini CLI and Grok in minutes: OAuth sign-in, config snippets, fixes for errors.<\/p>\n","protected":false},"author":1,"featured_media":3981,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"categories":[1084,975,988],"tags":[638,1488,1560,1561,1559,1210,1489],"class_list":["post-3982","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-ai-agents","category-ai-chatbots","category-business-tools","tag-ai-agents","tag-chatgpt-connectors","tag-claude-code-mcp","tag-cursor-mcp","tag-mcp-server","tag-model-context-protocol","tag-remote-mcp-server"],"aioseo_notices":[],"aioseo_head":"\n\t\t\n\t\n\t\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\thttps:\/\/chatmaxima.com\/mcp<\/code>. That is all a client needs to find it. If the server you want to use is “local” (something you run on your own machine with a command such as npx<\/code>), the steps differ, and only the coding tools below support that kind of server.<\/p>\n![\"One](\"https:\/\/chatmaxima.com\/blog\/wp-content\/uploads\/2026\/11\/how-to-connect-mcp-server-one-url.webp\")
<\/figure>\nRemote servers versus local servers<\/h3>\n
npx something<\/code> to add a server to Claude Desktop, it is a local server. If it hands you a URL, it is remote.<\/p>\nThe three steps every client shares<\/h2>\n
\n
Connect an MCP server to Claude (web and desktop)<\/h2>\n
\n
https:\/\/chatmaxima.com\/mcp<\/code>. Leave the client id and secret fields empty. A server that supports dynamic client registration fills those in during sign-in.<\/li>\nConnect an MCP server to Claude Code<\/h2>\n
claude mcp add --transport http --scope user chatmaxima https:\/\/chatmaxima.com\/mcp<\/code><\/pre>\n--scope user<\/code> flag makes the server available in every project. Leave it out and the server is added to the current folder only. If you want to share the configuration with teammates through the repository, use --scope project<\/code>, which writes a .mcp.json<\/code> file next to your code.<\/p>\n\n
\/mcp<\/code>.<\/li>\n\/mcp<\/code> lists the server as connected, with its tool count.<\/li>\n<\/ol>\nclaude mcp list<\/code> shows every configured server, claude mcp get chatmaxima<\/code> shows one entry, claude mcp logout chatmaxima<\/code> signs out, and claude mcp remove chatmaxima<\/code> deletes the entry. Anthropic documents all of them in the Claude Code MCP reference<\/a>. Each tool is exposed to Claude as mcp__<server>__<tool><\/code>, which is the name to use if you write permission rules.<\/p>\nConnect an MCP server to ChatGPT and Codex<\/h2>\n
ChatGPT<\/h3>\n
\n
Codex<\/h3>\n
~\/.codex\/config.toml<\/code>. The most compatible way to connect a remote OAuth server is through the mcp-remote<\/code> bridge, which runs the sign-in in your browser the first time and caches the token:<\/p>\n[mcp_servers.chatmaxima]\ncommand = \"npx\"\nargs = [\"-y\", \"mcp-remote\", \"https:\/\/chatmaxima.com\/mcp\"]<\/code><\/pre>\n![\"Connect](\"https:\/\/chatmaxima.com\/blog\/wp-content\/uploads\/2026\/11\/how-to-connect-mcp-server-chat-vs-coding.webp\")
<\/figure>\nConnect an MCP server to Cursor<\/h2>\n
\n
~\/.cursor\/mcp.json<\/code> in your home folder applies to every project.<\/li>\n.cursor\/mcp.json<\/code> inside a project applies to that project only.<\/li>\n<\/ul>\n{\n \"mcpServers\": {\n \"chatmaxima\": {\n \"url\": \"https:\/\/chatmaxima.com\/mcp\"\n }\n }\n}<\/code><\/pre>\ncursor:\/\/<\/code> link, so clicking it opens Cursor with the server pre-filled. If a link opens Cursor but nothing appears, the JSON method always works. ChatMaxima publishes one on its Cursor setup page.<\/p>\nConnect an MCP server to VS Code with GitHub Copilot<\/h2>\n
\n
chatmaxima<\/code>.<\/li>\nConnect an MCP server to Gemini CLI<\/h2>\n
gemini extensions install https:\/\/github.com\/chatmaxima-com\/chatmaxima-gemini-cli-extension<\/code><\/pre>\ngemini mcp add --transport http chatmaxima https:\/\/chatmaxima.com\/mcp<\/code><\/pre>\n\/mcp auth chatmaxima<\/code>, approve in the browser, and confirm with \/mcp list<\/code>, which prints the server and its tools.<\/p>\nConnect an MCP server to Grok<\/h2>\n
Grok on grok.com<\/h3>\n
\n
Grok Build<\/h3>\n
grok mcp add --transport http chatmaxima https:\/\/chatmaxima.com\/mcp<\/code><\/pre>\n\/mcps<\/code>, select the server, and press i<\/code>. Tools appear as chatmaxima__create_bot<\/code>, chatmaxima__list_bots<\/code> and so on. grok mcp doctor chatmaxima<\/code> diagnoses a connection that will not come up.<\/p>\n![\"ChatMaxima](\"https:\/\/chatmaxima.com\/blog\/wp-content\/uploads\/2026\/11\/how-to-connect-mcp-server-connected.webp\")
<\/figure>\nWhat to ask once the server is connected<\/h2>\n
List my chatbots and tell me which ones had errors this week.<\/code><\/pre>\nDraft a UTILITY WhatsApp template that confirms an appointment, with a\nReschedule quick reply, and show it to me before you submit it.<\/code><\/pre>\nBuild a lead capture bot for a real estate agency: ask for the area, budget\nand phone number, save the lead to contacts, then test it.<\/code><\/pre>\nWhat happens on the server side<\/h3>\n
Troubleshooting MCP connection errors<\/h2>\n
https:\/\/chatmaxima.com\/mcp<\/code> works with or without a trailing slash, but a typo in the host or a http:\/\/<\/code> prefix does not. Opening the URL in a browser shows nothing useful, because the server only speaks JSON-RPC over POST; that is normal, not a fault.<\/p>\nA short security checklist<\/h2>\n
\n
Connect once, then build<\/h2>\n