How it works
Common Ground is an MCP server: a standard door that AI assistants know how to open. You give your assistant the address above, sign in with your Common Ground account, and choose what it may do. From then on it works in your workspaces with your rights: what you can read, it can read; what you cannot, it cannot see. Every action is traced in the workspace journal in your name.
- Nothing to copy but the address and a Client ID. Claude and ChatGPT get their own credentials from the sign-in. No API key, no token, no secret.
- Two access levels. At sign-in you grant read only, or read and write. Read-only hides every writing tool from the assistant.
- Pages show as pages. In Claude, a wiki page or a deliverable opens as a panel inside the chat, with clickable links, not as a wall of text. Folders, search results, tables, the journal and your list of workspaces open as panels too.
Claude
Works on claude.ai, the desktop app and the mobile apps, on every plan (Free plans allow one custom connector).
- Open the connectors pageClick your name, then Settings › Connectors (on some accounts the menu is called Customize › Connectors).
- Add a custom connectorClick +, then Add custom connector. Name it Common Ground and paste the address
https://cg.ormind.ai/api/mcp. - Give it the Client IDOpen Advanced settings on the same form and paste this into OAuth Client ID (leave Client Secret empty), then click Add:
Without it, Claude registers a new sign-in client on every connection, and our sign-in service caps how many it keeps.OAuth Client ID
loading… - Connect and sign inClick Connect next to Common Ground. Sign in with your Common Ground account, then choose read only or read and write, and approve.
- Turn it on in a chatIn a conversation, click + › Connectors and switch Common Ground on. Then ask: “List my workspaces.”
- Allow the panelThe first time Claude opens a page, it asks permission to display the Common Ground app. Choose Always allow. Pages and deliverables then render inline.
Team or Enterprise plan?
An owner adds the connector once in Organization settings › Connectors › Add › Custom › Web, with the same address. Each member then clicks Connect in their own Settings › Connectors and signs in with their own account.
Tip: in the connector's settings you can set the reading tools to Always allow, so Claude stops asking before each read.
ChatGPT
Custom connectors are available on Plus, Pro, Business, Enterprise and Edu plans, on the web, behind a switch called Developer mode.
- Turn on Developer modeClick your name, Settings › Connectors (also shown as Apps & Connectors) › Advanced settings, and switch on Developer mode.
- Create the connectorBack on Connectors, click Create. Name: Common Ground. MCP server URL:
https://cg.ormind.ai/api/mcp. Authentication: OAuth. If the form offers an OAuth Client ID field, paste the same Client ID as for Claude (above) and leave the secret empty. Tick I trust this application, then Create. - Sign inChatGPT sends you to the Common Ground sign-in page. Sign in, choose read only or read and write, approve. ChatGPT then lists the available actions.
- Use it in a chatIn a new conversation, click + › More › Developer mode and select Common Ground. Then ask: “List my workspaces.”
ChatGPT asks you to confirm before any action that writes (filing a document, writing a page, adding to the journal). Reading needs no confirmation.
Claude Code
For the terminal, Common Ground gives you a personal agent token instead of a sign-in screen. The token is shown once; regenerating it revokes the previous one.
- Get your tokenIn Common Ground, open the profile menu › Models & Connections, then, under With Claude Code on your computer, generate your agent token.
- Paste the commandCommon Ground shows you the exact command. It looks like this:
claude mcp add --transport http common-ground https://cg.ormind.ai/api/mcp \ --header "Authorization: Bearer cg_…your token…"Prefer a file? The same page gives you a ready-made.mcp.jsonto drop in your project. - CheckIn Claude Code, type
/mcp: Common Ground should be listed as connected, with its tools.
Any other MCP client that speaks HTTP (Codex, Cursor, VS Code…) can use the same address and the same Authorization: Bearer header.
What you can ask
Name the workspace the first time; the assistant remembers it for the conversation.
Rights, traces and revocation
- Your rights, exactly. The assistant holds your role in each workspace: reader, editor or owner. A refusal is final and the assistant is told so.
- Every call is journaled in the workspace, in your name, with the assistant's name (for example Serge's Claude).
- Revoke any time. Claude: Settings › Connectors › remove. ChatGPT: Settings › Connectors › delete. Claude Code: regenerate or delete the agent token in Models & Connections.
Troubleshooting
| Claude shows the page as plain text, not as a panel | Panels open for reading requests: show me a page, what is in this folder, search for…, query the table, what deliverables are there, what happened lately (the journal), which workspaces do I have. Claude keeps the tool list from the moment you connected, so after an update on our side remove the connector and add it again. In Settings › Connectors › Common Ground, Claude counts the interactive tools it found: 7 is right. Then look for the permission prompt to display the Common Ground app and allow it. As of September 2026 the Claude website does not render panels from custom connectors (a known Claude issue); the Claude mobile and desktop apps do. |
| “Common Ground” does not appear in the chat | Connectors are switched on per conversation: + › Connectors in Claude, + › More › Developer mode in ChatGPT. |
| The assistant says “BLOCKED, this connection is read-only” | You granted read only. Remove the connector and connect again, choosing read and write. |
| A workspace is missing | The assistant only sees workspaces you are a member of. Ask the owner to invite you, then ask again. |
| Claude Code says the token is invalid | The token was regenerated or deleted. Get a new one in Models & Connections and run the command again. |
Something looks different on your screen?
Claude and ChatGPT move their menus around. Tell us and we will keep this page true.
Write to us