{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Getting Connected","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"getting-connected","__idx":0},"children":["Getting Connected"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"server-endpoint","__idx":1},"children":["Server endpoint"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Environment"},"children":["Environment"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"MCP URL"},"children":["MCP URL"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Production"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://mcp.resolvepay.com/mcp"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The server speaks streamable HTTP MCP. All requests require authentication — see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/mcp-authentication"},"children":["Authentication"]},"."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," MCP access must be enabled for your merchant account. If you don't see the option in your dashboard, contact your Resolve representative."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ways-to-connect","__idx":2},"children":["Ways to connect"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["There are two ways to connect, depending on who (or what) is using the MCP:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Native AI assistants (Claude, ChatGPT)"]}," — connect through an interactive OAuth sign-in using your own Resolve account, the same one you use for the dashboard. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/mcp-authentication#web-app-authentication"},"children":["Web App Authentication"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Custom MCP clients and agents"]}," — authenticate with a machine-to-machine (M2M) bearer token minted from an MCP access key. No interactive login required. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/mcp-authentication#machine-to-machine-m2m-authentication"},"children":["Machine-to-Machine (M2M) Authentication"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"connect-via-claude","__idx":3},"children":["Connect via Claude"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Claude Code (recommended: plugin)."]}," The ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/resolvepay/resolve-mcp-plugin"},"children":["Resolve plugin"]}," bundles the MCP connector and the skill in one install — add the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["resolvepay/resolve-mcp-plugin"]}," marketplace and install ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["resolve-mcp"]}," (see the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://code.claude.com/docs/en/plugins"},"children":["Claude Code plugins documentation"]},"). On first use, Claude Code opens the Resolve sign-in. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/mcp-skill"},"children":["Skills & Plugins"]}," for the optional domain plugins."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Claude (web / desktop), or manual setup:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In Claude, go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings > Connectors > Add custom connector"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter the server URL: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://mcp.resolvepay.com/mcp"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Claude redirects you to the Resolve login. Sign in with your Resolve account credentials (including Google login)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Approve the requested access. Claude stays connected using rotating refresh tokens — no need to sign in on every conversation."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For the best experience, also install the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/mcp-skill"},"children":["Resolve MCP skill"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"connect-via-chatgpt","__idx":4},"children":["Connect via ChatGPT"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In ChatGPT, enable ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Developer Mode"]}," (Settings > Apps & Connectors), then choose ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create"]}," / ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add connector"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter the server URL: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://mcp.resolvepay.com/mcp"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["ChatGPT redirects you to the Resolve login. Sign in and approve access."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For the best experience, also install the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/mcp-skill"},"children":["Resolve MCP skill"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"connect-via-codex","__idx":5},"children":["Connect via Codex"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/resolvepay/resolve-mcp-plugin"},"children":["Resolve plugin marketplace"]}," works in Codex too — add the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["resolvepay/resolve-mcp-plugin"]}," repo as a plugin marketplace and install ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["resolve-mcp"]}," (see the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://developers.openai.com/codex/plugins"},"children":["Codex plugins documentation"]},"). The plugin includes the MCP connector and the Codex-variant skill."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Codex prompts you to authenticate when the plugin installs. For headless or CI use, authenticate with an ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/mcp-authentication#machine-to-machine-m2m-authentication"},"children":["M2M token"]}," instead."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"connect-a-custom-mcp-client","__idx":6},"children":["Connect a custom MCP client"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Generate an MCP access key in the Merchant Dashboard, exchange it for a bearer token, and point your client at the server URL. Full walkthrough with example config in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/mcp-authentication#machine-to-machine-m2m-authentication"},"children":["Authentication"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"data-scoping--security","__idx":7},"children":["Data scoping & security"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The MCP enforces one load-bearing principle: ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["the AI sees only what the authenticated user can already see in the Resolve dashboard — nothing more."]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Every tool call runs under the identity of the authenticated merchant user (Web App Authentication) or the merchant that owns the access key (M2M) — M2M calls impersonate that account owner with no further auth, so keep access keys behind your own gated access."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Permissions mirror your dashboard roles: read-only logins get read tools only; write tools require a write-capable role. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/mcp-tools"},"children":["Tool Reference"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["There is no cross-merchant visibility and no AI-only data path."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["All MCP activity is audit-logged."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You can revoke access at any time: disconnect the connector in Claude/ChatGPT, or revoke the MCP access key in Merchant Dashboard."]}]}]},"headings":[{"value":"Getting Connected","id":"getting-connected","depth":1},{"value":"Server endpoint","id":"server-endpoint","depth":2},{"value":"Ways to connect","id":"ways-to-connect","depth":2},{"value":"Connect via Claude","id":"connect-via-claude","depth":3},{"value":"Connect via ChatGPT","id":"connect-via-chatgpt","depth":3},{"value":"Connect via Codex","id":"connect-via-codex","depth":3},{"value":"Connect a custom MCP client","id":"connect-a-custom-mcp-client","depth":3},{"value":"Data scoping & security","id":"data-scoping--security","depth":2}],"frontmatter":{"seo":{"title":"Getting Connected"}},"lastModified":"2026-07-10T16:44:03.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/mcp-connect","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}