Skip to content
TeamShared
Docs Blog Sign in
Start free

Connect MCP

TeamShared is one remote MCP server: https://teamshared.com/mcp. Pick your agent, paste the prompt, and it adds the server and runs the OAuth sign-in — the same emailed one-time code as the console. No install script, no API key.

https://teamshared.com/mcp
Sign in first

App connector

Claude.ai & Desktop

Custom connector in Claude.ai (shared with Claude Desktop). Claude cannot add its own connector, so these are UI steps.

Connector steps →

Paste a prompt

Claude Code

Claude Code adds the server and opens OAuth from /mcp.

Add the TeamShared MCP server at https://teamshared.com/mcp to Claude Code (run `claude mcp add --transport http teamshared https://teamshared.com/mcp`, user scope). Use OAuth sign-in (no API key). Then run the sign-in flow, tell me when to finish the emailed one-time code in the browser, and confirm by calling the `health` tool.

Steps →

Paste a prompt

Cursor

Cursor reads ~/.cursor/mcp.json; Connect finishes OAuth.

Add the TeamShared MCP server at https://teamshared.com/mcp to Cursor by adding a `teamshared` entry with the `url` field to ~/.cursor/mcp.json (no headers). Use OAuth sign-in (no API key). Then run the sign-in flow, tell me when to finish the emailed one-time code in the browser, and confirm by calling the `health` tool.

Add to Cursor Steps →

Button or prompt, one step is left: click Connect next to teamshared in Settings → Tools & MCP, finish the emailed code, then ask the agent to call health. If the button does not open the app, use the browser form of the link.

Paste a prompt

Codex

Codex registers the server and logs in through the system browser.

Add the TeamShared MCP server at https://teamshared.com/mcp to Codex (run `codex mcp add teamshared --url https://teamshared.com/mcp`), then run `codex mcp login teamshared`. If my browser is on a different device than this machine (for example I am on a phone), the sign-in ends on a 127.0.0.1 page that cannot load. In that case do not retry: tell me to copy the full 127.0.0.1 callback URL from that page and paste it here, then run `curl -sS '<that url>'` on this machine to finish the login. If that still fails, ask me for a TeamShared API key and use the key setup instead (export `TEAMSHARED_TOKEN`, and register with `--bearer-token-env-var TEAMSHARED_TOKEN`). Use OAuth sign-in (no API key). Then run the sign-in flow, tell me when to finish the emailed one-time code in the browser, and confirm by calling the `health` tool.

Steps →

App connector

ChatGPT

Custom connector in ChatGPT web. ChatGPT cannot add its own connector, so these are UI steps.

Connector steps →

Paste a prompt

VS Code / Copilot

Copilot Chat in agent mode reads .vscode/mcp.json and runs OAuth on start.

Add the TeamShared MCP server at https://teamshared.com/mcp to VS Code by adding a `teamshared` entry (`type: http`, `url` only, no headers) to .vscode/mcp.json, or run the `MCP: Add Server` command. Use OAuth sign-in (no API key). Then run the sign-in flow, tell me when to finish the emailed one-time code in the browser, and confirm by calling the `health` tool.

Add to VS Code Steps →

Button or prompt, one step is left: select Start on the server (VS Code opens the browser to sign in), then ask Copilot to call health. If the button does not open the app, use the browser form of the link.

Paste a prompt

Windsurf / Devin Desktop

Windsurf (now Devin Desktop) reads ~/.codeium/windsurf/mcp_config.json.

Add the TeamShared MCP server at https://teamshared.com/mcp to Windsurf (Devin Desktop) by merging a `teamshared` entry into ~/.codeium/windsurf/mcp_config.json. The remote field must be `serverUrl`, not `url`. Use OAuth sign-in (no API key). Then run the sign-in flow, tell me when to finish the emailed one-time code in the browser, and confirm by calling the `health` tool.

Steps →

Paste a prompt

Gemini CLI

Gemini CLI adds the server and authenticates from /mcp auth.

Add the TeamShared MCP server at https://teamshared.com/mcp to Gemini CLI (run `gemini mcp add --transport http teamshared https://teamshared.com/mcp`), then start `/mcp auth teamshared`. Use OAuth sign-in (no API key). Then run the sign-in flow, tell me when to finish the emailed one-time code in the browser, and confirm by calling the `health` tool.

Steps →

App connector

Gemini

Custom MCP app on gemini.google.com. Gemini cannot add its own connector, so these are UI steps.

Connector steps →

App connector

Devin

Devin on the web (app.devin.ai) registers with OAuth. Devin cannot add its own connector, so these are UI steps.

Connector steps →

App connector

Grok Bot

Grok Bot adds MCP servers from its connectors screen, so these are UI steps.

Connector steps →

Paste a prompt

OpenClaw

OpenClaw takes an org key on the Authorization header.

Add the TeamShared MCP server at https://teamshared.com/mcp to OpenClaw (`mcp_servers.teamshared`). Use OAuth sign-in if OpenClaw supports it; otherwise ask me for my TeamShared API key (from https://teamshared.com/app/keys) and send it as `Authorization: Bearer <key>`. Set timeout 120 and connect_timeout 30, restart OpenClaw, and confirm by calling the `health` tool.

Steps →

Paste a prompt

Hermes

Hermes takes an org key on the Authorization header.

Add the TeamShared MCP server at https://teamshared.com/mcp to Hermes (`mcp_servers.teamshared` in ~/.hermes/config.yaml, or `hermes mcp add teamshared --url ... --auth header`). Use OAuth sign-in if Hermes supports it; otherwise ask me for my TeamShared API key (from https://teamshared.com/app/keys) and send it as `Authorization: Bearer <key>`. Set timeout 120 and connect_timeout 30, disable Hermes's built-in memory toolset (`hermes tools disable memory`), reload MCP, and confirm by calling the `health` tool.

Steps →

Several orgs

Use the org’s own URL, https://teamshared.com/o/<org-slug>/mcp (Copy connector URL in the console org menu), so every session starts in that org. The bare URL uses the org picked at sign-in, or the one marked Make MCP default on All organizations.

API key fallback

Mint a tsk_ key under API Keys only for CI, headless agents, or a harness that cannot do OAuth, and send it as Authorization: Bearer tsk_…. Each agent page has the exact manual config in a collapsed section.

Start free with your email →

TeamShared
Privacy Security Terms Prepaid credits Refunds Tax Pricing Docs Blog Sign in