{"article":{"id":52836928453523,"url":"https://growsumo.zendesk.com/api/v2/help_center/en-us/articles/52836928453523.json","html_url":"https://support.partnerstack.com/hc/en-us/articles/52836928453523-Connecting-PartnerStack-MCP","author_id":17718544894099,"comments_disabled":false,"draft":false,"promoted":true,"position":0,"vote_sum":0,"vote_count":0,"upvote_count":0,"downvote_count":0,"section_id":360001875454,"created_at":"2026-06-23T13:36:15Z","updated_at":"2026-09-24T17:20:47Z","name":"Connecting PartnerStack MCP","title":"Connecting PartnerStack MCP","source_locale":"en-us","locale":"en-us","outdated":false,"outdated_locales":[],"edited_at":"2026-09-24T17:20:47Z","user_segment_id":null,"permission_group_id":2332174,"content_tag_ids":[],"label_names":[],"body":"<p>PartnerStack is shipping our official <span data-token-index=\"1\">remote MCP (Model Context Protocol) server</span> that lets AI assistants read and (with your confirmation) write to your program data: partnerships, customers, leads, deals, transactions, rewards, links, and custom report exports, all in natural language.</p><figure class=\"wysiwyg-table wysiwyg-table-align-left\"><table>\n<thead><tr>\n<th><strong>MCP server URL</strong></th>\n<th><code>https://mcp.partnerstack.com/mcp</code></th>\n</tr></thead>\n<tbody>\n<tr>\n<td><strong>Authentication</strong></td>\n<td>OAuth — your normal PartnerStack login.</td>\n</tr>\n<tr>\n<td><strong>Permissions required</strong></td>\n<td>Any active PartnerStack team member (what you can do through the connection still follows your normal PartnerStack permissions).</td>\n</tr>\n</tbody>\n</table></figure><blockquote><p>💡 <strong>One server, two ways to add it.</strong> Depending on your AI tool and your license tier, you’ll either add PartnerStack yourself as a <em>custom connector / app</em>, or your IT/workspace admin will need to enable it for you. Each section below tells you which path applies</p></blockquote><h3 id=\"h_01KVT9ZK19PP7CFQPCKJXH9CJY\">Before you start: do I need my IT team?</h3><p>This is the first thing to figure out, because it changes everything downstream.</p><figure class=\"wysiwyg-table wysiwyg-table-align-left\"><table>\n<thead><tr>\n<th>AI tool</th>\n<th>Can a regular user add a custom MCP themselves?</th>\n<th>When IT/admin is required</th>\n</tr></thead>\n<tbody>\n<tr>\n<td>\n<strong>Claude</strong> (Desktop / Web / Code)</td>\n<td>✅ Yes, on any paid plan that supports custom connectors</td>\n<td>Enterprise plans may restrict custom connectors at the org level</td>\n</tr>\n<tr>\n<td><strong>ChatGPT</strong></td>\n<td>⚠️ Depends on plan — <strong>Plus / Pro</strong> users self-enable; <strong>Business</strong>: only admins can use Developer Mode; <strong>Enterprise / Edu</strong>: admin grants access, then users enable it</td>\n<td>Business: admin-only. Enterprise/Edu: An admin has to switch on developer mode and publish the PartnerStack app before your team can use it</td>\n</tr>\n<tr>\n<td><strong>Gemini</strong></td>\n<td>❌ Not via self-serve. The <strong>consumer Gemini app</strong> only supports a small set of Google-approved partner connectors (no custom-URL field). Use <strong>Gemini CLI</strong> (self-serve, technical) or <strong>Gemini Enterprise</strong> (admin-configured) for a custom server</td>\n<td>Gemini Enterprise data-store setup is an IT/Cloud-admin task</td>\n</tr>\n<tr>\n<td>\n<strong>Other agents</strong> (Cursor, VS Code, Cline, etc.)</td>\n<td>✅ Usually yes — they support remote MCP directly</td>\n<td>Locked-down corporate machines may block config changes</td>\n</tr>\n</tbody>\n</table></figure><h3 id=\"h_01KVTA1HFCPN23RW1802WKJGY8\">Connecting to Claude or ChatGPT</h3><h2 id=\"h_01KVTA1WZ6KCD90S80J0XWRXFP\">Claude</h2><p>Claude has the most mature, self-serve MCP support. Pick the client you use.</p><p><img class=\"wysiwyg-image-resized\" style=\"aspect-ratio: 1088/482; width: 57.21%;\" src=\"https://support.partnerstack.com/hc/article_attachments/52836962053779\" alt=\"mcp doc.png\" width=\"1088\" height=\"482\"></p><p>💡 PartnerStack MCP is being reviewed by Anthropic and will be available in the connector directory, meanwhile, the best way to using PartnerStack MCP is via Custom Connector.</p><h3 id=\"h_01KVTASBCT63CM4YK17H9JSR8H\">Option A — Claude Desktop</h3><ol>\n<li data-list-item-id=\"eebca95893f5727b0c453b653cf369768\">Open <strong>Claude Desktop → Settings → Connectors</strong>.</li>\n<li data-list-item-id=\"e76ffb4dfa80304f5e8eda14d9f70ac2b\">Click <strong>Add —&gt; Add custom connector</strong>.</li>\n<li data-list-item-id=\"efdcfc641fd073c6accf6bafd65f49f7b\">Enter:<ul>\n<li data-list-item-id=\"efc8cbb298e088ab0dd532703c426a44e\">\n<strong>Name:</strong> <code>PartnerStack</code>\n</li>\n<li data-list-item-id=\"edcdd84a95579f669c7b8f75681242c39\">\n<strong>Remote MCP server URL:</strong> <code>https://mcp.partnerstack.com/mcp</code>\n</li>\n</ul>\n</li>\n<li data-list-item-id=\"eb61d504e9bc1dc3f381476e756d87f4a\">\n<strong>Save.</strong> Claude opens a browser window to PartnerStack — sign in and approve access.</li>\n<li data-list-item-id=\"e351b209edb1068e5d5e2e0cbed5195a3\">Return to Claude. PartnerStack tools are now available in any <strong>new</strong> conversation.</li>\n</ol><blockquote><p>💡 <strong>Multi-instance note:</strong> If you have access to multiple PartnerStack instances, select the correct one on the authorization screen (top left). The MCP server connects to <strong>one instance at a time</strong>. If you picked the wrong instance, disconnect the MCP, and connect again.</p></blockquote><p><img class=\"wysiwyg-image-resized\" style=\"aspect-ratio: 1570/742; width: 56.3%;\" src=\"https://support.partnerstack.com/hc/article_attachments/52836928451603\" alt=\"mcp-auth (1).png\" width=\"1570\" height=\"742\"></p><p> </p><p><span data-token-index=\"0\">If your Claude Desktop doesn’t show “Add custom connector”, </span>you can either ask your IT Admin team to add to your account, or configure the <span style=\"background-color: #CEE2F2;\"><span data-token-index=\"2\">claude_desktop_config.json </span></span>manually. </p><div>Edit :</div><div> </div><pre class=\"language-auto\">{\n  \"mcpServers\": {\n    \"partnerstack\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"mcp-remote\",\n        \"&lt;https://mcp.partnerstack.com/mcp&gt;\"\n      ]\n    }\n  }\n}\n</pre><div> </div><div>Restart Claude Desktop. A browser window opens on first tool use so you can sign in and grant access.</div><h3 id=\"h_01KVTAANMCWQYAXA9GJTFGQEK2\">Option B — <a href=\"http://Claude.ai\">Claude.ai</a> (web)</h3><ol>\n<li data-list-item-id=\"e0f02e26b4d9a9578170022a9eb4998b7\">Go to <strong>Settings → Connectors → Browse connectors</strong>.</li>\n<li data-list-item-id=\"eb5ab72802fa0746b5c0c875d7f5096fb\">Select <strong>PartnerStack</strong> from the directory — <em>or</em> click <strong>Add custom connector</strong> and enter <code>https://mcp.partnerstack.com/mcp</code>.</li>\n<li data-list-item-id=\"e060517c4a3223355af0602a749032e5a\">Click <strong>Connect</strong>, sign in to PartnerStack, and approve.</li>\n</ol><blockquote><p><strong>If your Claude Web doesn’t show “Add custom connector”,</strong> you can ask your IT Admin team to add to your account.</p></blockquote><h3 id=\"h_01KVTABQ7VQ2J8ERC70F2CHW34\">Option C — Claude Code (CLI)</h3><pre class=\"language-auto\">claude mcp add --transport http partnerstack &lt;https://mcp.partnerstack.com/mcp&gt;\n</pre><p>You’ll be walked through the same browser sign-in on first use.</p><h2 id=\"h_01KVTAD40MV12T1X5XCRRCDYDN\">ChatGPT</h2><p>ChatGPT supports custom MCP servers through <strong>Developer Mode</strong>. The key fact: <strong>the setup differs by plan</strong>, and on company plans an admin has to switch it on first.</p><blockquote><p><strong>Eligibility:</strong> Developer Mode is available to <strong>Plus, Pro, Business, Enterprise, and Education</strong> accounts <strong>on the web</strong>. <strong>Free ChatGPT may not support custom connectors.</strong></p></blockquote><h3 id=\"h_01KVTADDC9CZFPWVX04G8B7AJJ\">Step 1 — Enable Developer Mode</h3><p><strong>If you’re on ChatGPT Plus or Pro (individual):</strong></p><ol>\n<li data-list-item-id=\"e7dc999a243c98b7ea0564a4a9a6a7ca6\">Go to <strong>Settings → Apps → Advanced settings</strong>.</li>\n<li data-list-item-id=\"eb6b0761addc3ffba6e238f2e53efb239\">Toggle <strong>Developer Mode</strong> to <strong>ON</strong>.</li>\n<li data-list-item-id=\"e0348b928ef54333f4ed3f13e65b8e2bb\">Confirm the warning. (Custom connectors are not verified by OpenAI — only add servers you trust. PartnerStack’s is an official first-party server.)</li>\n</ol><p><strong>If you’re on ChatGPT Business / Enterprise / Edu</strong> (the enablement path differs by plan):</p><ul>\n<li data-list-item-id=\"eba2730a621b9e9e43a610e4c1f39236d\">\n<strong>Business:</strong> Only <strong>admins/owners</strong> can use Developer Mode — regular members can’t enable or use it. If you’re a Business member, your admin will need to set up the connector.</li>\n<li data-list-item-id=\"ece89d9b24cc5dc8f21a5d5b2a927ae5f\">\n<strong>Enterprise:</strong> An admin first grants access under <strong>Workspace Settings → Permissions &amp; Roles → Connected Data</strong>. <em>Then</em> enabled users turn Developer Mode on themselves via <strong>Settings → Apps → Advanced settings</strong>. Only admins/owners can publish apps for the workspace, and access can be scoped by role (RBAC).</li>\n<li data-list-item-id=\"e0552f96179a3fde1c866a05e42207b94\">👉 <em>This is your “ask IT” path — send them the URL </em><code><em>https://mcp.partnerstack.com/mcp</em></code><em> and this section.</em>\n</li>\n</ul><h3 id=\"h_01KVTADTM3XR2ABPJPBK84ZFGB\">Step 2 — Create the PartnerStack app</h3><ol>\n<li data-list-item-id=\"e2cc825a93f37e6135401ad02c362d09b\">Open the right settings page:<ul>\n<li data-list-item-id=\"ea97a3ba849ac94fc494ee1fad653abb6\">\n<strong>Admins/owners:</strong> <strong>Workspace settings → Apps → Create</strong> </li>\n<li data-list-item-id=\"e51f955635abf27d0c8356c52c1b24a68\">\n<strong>Authorized members:</strong> <strong>Settings → Apps → Create</strong>\n</li>\n</ul>\n</li>\n<li data-list-item-id=\"e744b42082605a35cf4f70a3e1470cee8\">Enter:<ul>\n<li data-list-item-id=\"e124ca256b2c34f4e208a30eaf56689a2\">\n<strong>Name:</strong> <code>PartnerStack</code>\n</li>\n<li data-list-item-id=\"e3e1c31882270ef903db9fdaf836bbdc2\">\n<strong>MCP Server URL:</strong> <code>https://mcp.partnerstack.com/mcp</code>\n</li>\n<li data-list-item-id=\"ea0f56987a242d3f63f353f299f79a53e\">\n<strong>Authentication:</strong> OAuth</li>\n</ul>\n</li>\n<li data-list-item-id=\"e2fa8aabba03769adbf1ea67fbc8e25fe\">Click <strong>Scan Tools</strong>. When the PartnerStack sign-in window opens, log in, choose the correct PartnerStack instance, and approve access. Make sure pop-ups aren't blocked. </li>\n<li data-list-item-id=\"e62718cfec89146077fa41d7a55ca0116\">Wait for the scan to finish, then click <strong>Create</strong>. </li>\n<li data-list-item-id=\"e51ba159ca851c7db29502f45104e470c\">The app is saved as a draft. It appears in <strong>Workspace Settings → Apps → Drafts</strong> and in <strong>Settings → Apps → Enabled Apps</strong> with a <strong>Dev</strong> label.</li>\n</ol><h3 id=\"h_01KVTAE8DCNJCFHTAQBC1QT8NE\">Step 3 — Test it</h3><ol>\n<li data-list-item-id=\"e3e5b9b59101e0d811ca1efba19a64ea6\">Open a new chat and select <strong>PartnerStack</strong> from the tools menu, or mention it in your prompt. </li>\n<li data-list-item-id=\"e729c734965399eee561c9ae634272094\">Try a few requests, for example: \"Use PartnerStack to list my top 10 partnerships by created date.\"</li>\n</ol><h3 id=\"h_01M3A6PZZNRE1ZM0A2E9MW6KPT\">Step 4: Publish to your workspace (admin/owner)</h3><ol dir=\"ltr\">\n<li data-list-item-id=\"e5a2cca94404bfeff783df4d9e6834801\">Go to <strong>Workspace settings → Apps → Drafts</strong> and click <strong>Publish</strong> on PartnerStack. </li>\n<li data-list-item-id=\"ee69c7a05ccdc15d0a29f3c5dedda4008\">In the publish window:<ul>\n<li data-list-item-id=\"eb3b9e795ae27ddccd9b2b15a47c22a1b\">Use <strong>Configure Actions</strong> to choose which PartnerStack actions are allowed.</li>\n<li data-list-item-id=\"e29b54f59735531cc9a151da944a1da22\">Use <strong>Configure Access</strong> to choose which groups can use the app.</li>\n</ul>\n</li>\n<li data-list-item-id=\"e45a65ee0d5f7a04ebb43942e19b2280b\">Once published, PartnerStack appears in users' <strong>Apps</strong> settings with a <strong>custom</strong> label.</li>\n</ol><h3 id=\"h_01M3A6W0HM4S8NTSNFT06X52Y1\">Step 5: Use it in a conversation</h3><ol dir=\"ltr\">\n<li data-list-item-id=\"e588df878d7c2cc3181cdbd0cc3c32408\">Select <strong>PartnerStack</strong> from the tools menu, or @mention it in your message.</li>\n<li data-list-item-id=\"e868f31f49ff7853f7d853550963af603\">Selecting the app applies only to that message. @mention it again when a follow-up needs fresh data or a new action.</li>\n<li data-list-item-id=\"ef14121c06ec8c0028a0c45fb54c56603\">ChatGPT may ask you to confirm before it creates or updates anything in PartnerStack.</li>\n</ol><h1 id=\"h_01KVTAEMBMCFBPKBWXVPFY0RVB\">Other Agents &amp; MCP Clients</h1><p>Any MCP-compatible client that supports <strong>remote servers with OAuth</strong> can connect to PartnerStack. The details are always the same:</p><figure class=\"wysiwyg-table wysiwyg-table-align-left\"><table>\n<thead><tr>\n<th>Setting</th>\n<th>Value</th>\n</tr></thead>\n<tbody>\n<tr>\n<td>Server URL</td>\n<td><code>https://mcp.partnerstack.com/mcp</code></td>\n</tr>\n<tr>\n<td>Transport</td>\n<td>Streamable HTTP</td>\n</tr>\n<tr>\n<td>Auth</td>\n<td>OAuth (browser sign-in on first use)</td>\n</tr>\n</tbody>\n</table></figure><h3 id=\"h_01KVTAG4FBHS3J5PEWB2V12Y4B\">Common clients</h3><h4 id=\"h_01KVTAK3Q84PRNW7ZC645QDRKP\">\n<strong>Cursor</strong><br>Open <strong>Settings</strong> → <strong>Tools &amp; MCP</strong> → <strong>New MCP Server</strong> (this opens <code>mcp.json</code>), or create the file manually at <code>.cursor/mcp.json</code> (project) or <code>~/.cursor/mcp.json</code> (global):</h4><pre class=\"language-auto\">{\n  \"mcpServers\": {\n    \"partnerstack\": {\n      \"url\": \"&lt;https://mcp.partnerstack.com/mcp&gt;\"\n    }\n  }\n}\n</pre><p>Cursor triggers the browser OAuth flow on first connect and stores the credentials.</p><h4 id=\"h_01KVTAKHXM5BED1RMYCNW8R77A\">\n<span data-token-index=\"0\"><strong>VS Code (GitHub Copilot agent mode)</strong></span><strong> </strong>\n</h4><p>Add a <span data-token-index=\"2\">.</span><span style=\"background-color: #CEE2F2;\"><span data-token-index=\"2\">vscode/mcp.json </span></span>(or via <span data-token-index=\"4\">MCP: Add Server</span>):</p><pre class=\"language-auto\">{\n  \"servers\": {\n    \"partnerstack\": {\n      \"type\": \"http\",\n      \"url\": \"&lt;https://mcp.partnerstack.com/mcp&gt;\"\n    }\n  }\n}\n</pre><h4 id=\"h_01KVTAMKQHZCQB0R71524228T8\">\n<span data-token-index=\"0\">Cline / Windsurf / Goose / LibreChat and similar</span> </h4><p>Add a remote/HTTP MCP server entry pointing to <a href=\"https://mcp.partnerstack.com/mcp\"><span style=\"background-color: #CEE2F2;\"><span data-token-index=\"2\">https://mcp.partnerstack.com/mcp</span></span></a><span style=\"background-color: #CEE2F2;\"><span data-token-index=\"2\"> </span></span></p><div>Complete the OAuth sign-in when prompted.</div><h3 id=\"h_01KVTATEVCE62TWT4384NQ7KJD\">Clients that only support local (stdio) servers</h3><p>Some older or local-only clients can’t talk to a remote HTTPS server directly. Bridge it with <code><strong>mcp-remote</strong></code>:</p><pre class=\"language-auto\">{\n  \"mcpServers\": {\n    \"partnerstack\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-remote\", \"&lt;https://mcp.partnerstack.com/mcp&gt;\"]\n    }\n  }\n}\n</pre><p>This launches a local proxy that forwards to the remote server and handles the browser OAuth flow on first run.</p><blockquote><p>💡 <strong>Rule of thumb:</strong> if a client asks for a <strong>URL</strong>, paste the endpoint directly. If it only asks for a <strong>command</strong>, use the <code>mcp-remote</code> bridge above.</p></blockquote><h2 id=\"h_01KVTAQC555D9AY3BFKGPPD5F5\">Security &amp; privacy</h2><ul>\n<li data-list-item-id=\"e8e155e890e8328386b1a61a1899a3f1a\">\n<strong>Encrypted in transit</strong> — all traffic runs over HTTPS/TLS.</li>\n<li data-list-item-id=\"e9a0c849af64d4ba3fe1e4425c8bdc8c0\">\n<strong>No vendor data stored on the MCP server</strong> — responses aren’t persisted; your data stays in PartnerStack’s system of record behind your existing permissions.</li>\n<li data-list-item-id=\"e050ebcb146e6b8888aee49e71c9b2fb7\">\n<strong>Tenant isolation</strong> — every request runs under the OAuth token you approved at sign-in; the server can’t read outside that token’s account and scopes.</li>\n<li data-list-item-id=\"e67da4e14c45fb7bade02d8eb40be37a7\">\n<strong>Confirmation before writes</strong> — the server instructs the assistant to confirm with you before any create/update/convert/delete.</li>\n</ul><p>Policies: <a href=\"https://partnerstack.com/privacy-policy\">partnerstack.com/privacy-policy</a> · <a href=\"https://partnerstack.com/terms-of-service\">partnerstack.com/terms-of-service</a></p><h2 id=\"h_01KVTAQR9NY9TNNE9R2M0D243C\">Troubleshooting</h2><figure class=\"wysiwyg-table wysiwyg-table-align-left\"><table>\n<thead><tr>\n<th>Symptom</th>\n<th>Fix</th>\n</tr></thead>\n<tbody>\n<tr>\n<td><strong>“Not authenticated: no OAuth access token was found.”</strong></td>\n<td>Your PartnerStack session for the connector expired. Reconnect (e.g. Claude → Settings → Connectors → PartnerStack → <strong>Reconnect</strong>).</td>\n</tr>\n<tr>\n<td>\n<strong>Assistant keeps asking me to re-authenticate</strong> (Claude Desktop)</td>\n<td>Quit Claude, clear cached credentials with <code>rm -rf ~/.mcp-auth/mcp-remote-*</code>, relaunch, and re-add the connector.</td>\n</tr>\n<tr>\n<td><strong>A list returned only some results</strong></td>\n<td>PartnerStack paginates. Tell the assistant <em>“continue”</em> / <em>“get the next page.”</em>\n</td>\n</tr>\n<tr>\n<td><strong>Tools don’t show up</strong></td>\n<td>Run <code>/mcp</code> to check connection status and complete OAuth if prompted; restart after editing <code>settings.json</code>.</td>\n</tr>\n<tr>\n<td>\n<strong>OAuth popup never appears</strong> (ChatGPT / web clients)</td>\n<td>Allow pop-ups for the site and retry.</td>\n</tr>\n<tr>\n<td>\n<strong>“Create app” button missing</strong> (ChatGPT)</td>\n<td>Developer Mode isn’t on — enable it (or ask your workspace admin to).</td>\n</tr>\n</tbody>\n</table></figure><div> </div>"}}