PartnerStack is shipping our official remote MCP (Model Context Protocol) server 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.
| MCP server URL | https://mcp.partnerstack.com/mcp |
|---|---|
| Authentication | OAuth — your normal PartnerStack login. |
| Permissions required | NOW: PartnerStack account with Admin or Integration (full) permissions. |
| LATER: All users will be able to connect using MCP, following their PartnerStack user permissions. |
💡 One server, two ways to add it. Depending on your AI tool and your license tier, you’ll either add PartnerStack yourself as a custom connector / app, or your IT/workspace admin will need to enable it for you. Each section below tells you which path applies
Before you start: do I need my IT team?
This is the first thing to figure out, because it changes everything downstream.
| AI tool | Can a regular user add a custom MCP themselves? | When IT/admin is required |
|---|---|---|
| Claude (Desktop / Web / Code) | ✅ Yes, on any paid plan that supports custom connectors | Enterprise plans may restrict custom connectors at the org level |
| ChatGPT | ⚠️ Depends on plan — Plus / Pro users self-enable; Business: only admins can use Developer Mode; Enterprise / Edu: admin grants access, then users enable it | Business: admin-only. Enterprise/Edu: admin must grant access in Permissions & Roles first |
| Gemini | ❌ Not via self-serve. The consumer Gemini app only supports a small set of Google-approved partner connectors (no custom-URL field). Use Gemini CLI (self-serve, technical) or Gemini Enterprise (admin-configured) for a custom server | Gemini Enterprise data-store setup is an IT/Cloud-admin task |
| Other agents (Cursor, VS Code, Cline, etc.) | ✅ Usually yes — they support remote MCP directly | Locked-down corporate machines may block config changes |
Connecting to Claude or ChatGPT
Claude
Claude has the most mature, self-serve MCP support. Pick the client you use.
💡 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.
Option A — Claude Desktop
- Open Claude Desktop → Settings → Connectors.
- Click Add —> Add custom connector.
- Enter:
-
Name:
PartnerStack -
Remote MCP server URL:
https://mcp.partnerstack.com/mcp
-
Name:
- Save. Claude opens a browser window to PartnerStack — sign in and approve access.
- Return to Claude. PartnerStack tools are now available in any new conversation.
💡 Multi-instance note: If you have access to multiple PartnerStack instances, select the correct one on the authorization screen (top left). The MCP server connects to one instance at a time. If you picked the wrong instance, disconnect the MCP, and connect again.
If your Claude Desktop doesn’t show “Add custom connector”, you can either ask your IT Admin team to add to your account, or configure the claude_desktop_config.json manually.
{
"mcpServers": {
"partnerstack": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"<https://mcp.partnerstack.com/mcp>"
]
}
}
}
Option B — Claude.ai (web)
- Go to Settings → Connectors → Browse connectors.
- Select PartnerStack from the directory — or click Add custom connector and enter
https://mcp.partnerstack.com/mcp. - Click Connect, sign in to PartnerStack, and approve.
If your Claude Web doesn’t show “Add custom connector”, you can ask your IT Admin team to add to your account.
Option C — Claude Code (CLI)
claude mcp add --transport http partnerstack <https://mcp.partnerstack.com/mcp>
You’ll be walked through the same browser sign-in on first use.
ChatGPT
ChatGPT supports custom MCP servers through Developer Mode. The key fact: the setup differs by plan, and on company plans an admin has to switch it on first.
Eligibility: Developer Mode is available to Plus, Pro, Business, Enterprise, and Education accounts on the web. Free ChatGPT may not support custom connectors.
Step 1 — Enable Developer Mode
If you’re on ChatGPT Plus or Pro (individual):
- Go to Settings → Apps → Advanced settings.
- Toggle Developer Mode to ON.
- Confirm the warning. (Custom connectors are not verified by OpenAI — only add servers you trust. PartnerStack’s is an official first-party server.)
If you’re on ChatGPT Business / Enterprise / Edu (the enablement path differs by plan):
- Business: Only admins/owners 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.
- Enterprise: An admin first grants access under Workspace Settings → Permissions & Roles → Connected Data. Then enabled users turn Developer Mode on themselves via Settings → Apps → Advanced settings. Only admins/owners can publish apps for the workspace, and access can be scoped by role (RBAC).
- 👉 This is your “ask IT” path — send them the URL
https://mcp.partnerstack.com/mcpand this section.
Step 2 — Create the PartnerStack app
- Open ChatGPT → Settings → Apps (Connectors).
- Next to Advanced settings, click Create app. (This button only appears when Developer Mode is on.)
- Enter:
-
Name:
PartnerStack -
MCP Server URL:
https://mcp.partnerstack.com/mcp - Authentication: OAuth
-
Name:
- Save. The app appears under Drafts in app settings.
Step 3 — Use it in a conversation
- In a new chat, open the Plus menu → Developer Mode and select the PartnerStack app.
- The first time you call a tool, ChatGPT opens an OAuth popup — sign in to PartnerStack and approve. (Make sure pop-ups aren’t blocked.)
- Prompt explicitly for best results, e.g. “Use the PartnerStack app to list my top 10 partnerships by created date.”
Other Agents & MCP Clients
Any MCP-compatible client that supports remote servers with OAuth can connect to PartnerStack. The details are always the same:
| Setting | Value |
|---|---|
| Server URL | https://mcp.partnerstack.com/mcp |
| Transport | Streamable HTTP |
| Auth | OAuth (browser sign-in on first use) |
Common clients
Cursor
Open Settings → Tools & MCP → New MCP Server (this opens mcp.json), or create the file manually at .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):
{
"mcpServers": {
"partnerstack": {
"url": "<https://mcp.partnerstack.com/mcp>"
}
}
}
Cursor triggers the browser OAuth flow on first connect and stores the credentials.
VS Code (GitHub Copilot agent mode)
Add a .vscode/mcp.json (or via MCP: Add Server):
{
"servers": {
"partnerstack": {
"type": "http",
"url": "<https://mcp.partnerstack.com/mcp>"
}
}
}
Cline / Windsurf / Goose / LibreChat and similar
Add a remote/HTTP MCP server entry pointing to https://mcp.partnerstack.com/mcp
Clients that only support local (stdio) servers
Some older or local-only clients can’t talk to a remote HTTPS server directly. Bridge it with mcp-remote:
{
"mcpServers": {
"partnerstack": {
"command": "npx",
"args": ["-y", "mcp-remote", "<https://mcp.partnerstack.com/mcp>"]
}
}
}
This launches a local proxy that forwards to the remote server and handles the browser OAuth flow on first run.
💡 Rule of thumb: if a client asks for a URL, paste the endpoint directly. If it only asks for a command, use the
mcp-remotebridge above.
Security & privacy
- Encrypted in transit — all traffic runs over HTTPS/TLS.
- No vendor data stored on the MCP server — responses aren’t persisted; your data stays in PartnerStack’s system of record behind your existing permissions.
- Tenant isolation — every request runs under the OAuth token you approved at sign-in; the server can’t read outside that token’s account and scopes.
- Confirmation before writes — the server instructs the assistant to confirm with you before any create/update/convert/delete.
Policies: partnerstack.com/privacy-policy · partnerstack.com/terms-of-service
Troubleshooting
| Symptom | Fix |
|---|---|
| “Not authenticated: no OAuth access token was found.” | Your PartnerStack session for the connector expired. Reconnect (e.g. Claude → Settings → Connectors → PartnerStack → Reconnect). |
| Assistant keeps asking me to re-authenticate (Claude Desktop) | Quit Claude, clear cached credentials with rm -rf ~/.mcp-auth/mcp-remote-*, relaunch, and re-add the connector. |
| A list returned only some results | PartnerStack paginates. Tell the assistant “continue” / “get the next page.” |
| Tools don’t show up | Run /mcp to check connection status and complete OAuth if prompted; restart after editing settings.json. |
| OAuth popup never appears (ChatGPT / web clients) | Allow pop-ups for the site and retry. |
| “Create app” button missing (ChatGPT) | Developer Mode isn’t on — enable it (or ask your workspace admin to). |