One API key, one organization
Every ContactShip API key belongs to a single organization: the MCP server derives the organization from the key, and the API rejects any attempt to use it with another one. To work with several organizations from Claude or Cursor, connect ContactShip once per organization, each connection with its own key.
Give each connection a distinct name, for example contactship-acme and contactship-beta. That is the name you will use to tell the assistant which organization to work on.
Claude Code
Add one connection per organization, each with that organization’s key:
Check with claude mcp list: both connections should be listed. To remove one:
Cursor
In .cursor/mcp.json, one entry per organization:
Claude Desktop
Same format in claude_desktop_config.json, under mcpServers.
Claude.ai (web)
Add the connector once per organization from Settings > Integrations > Add custom connector, with a different name each time (for example ContactShip · Acme and ContactShip · Beta) and the same URL https://mcp.contactship.ai/mcp. Each connector will ask you to authorize with that organization’s API key.
How to phrase requests
With more than one connection, the assistant sees the same tools repeated, once per organization. Name the organization in your request and the assistant picks the right connection:
“In Acme, show me today’s unanswered conversations”
“Compare this week’s answered calls for Acme and Beta”
If you don’t name it and several are connected, the assistant may ask which one you mean, or pick one. When it matters, say it explicitly.
Keep in mind
Each connection adds ContactShip’s full tool set to the assistant’s context. Two or three organizations work well; with many more, the assistant takes longer to choose and uses more context on every message. If you need to operate many organizations routinely, contact support.
- A key never sees another organization’s data, even when both are connected in the same assistant.
- If you rotate one organization’s key, update only that connection.
- In Claude Code and Cursor, tools carry the connection name as a prefix; in Claude.ai they are grouped by connector. That lets you verify which organization an action ran against.
