How it works
Ormind 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 Ormind account, and choose what it may do. From then on it works in your dossiers with your rights: what you can read, it can read; what you cannot, it cannot see. Every action is traced in the dossier 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 dossiers 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 Ormind and paste the address
https://app.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 Ormind. Sign in with your Ormind account, then choose read only or read and write, and approve.
- Turn it on in a chatIn a conversation, click + › Connectors and switch Ormind on. Then ask: “List my workspaces.”
- Allow the panelThe first time Claude opens a page, it asks permission to display the Ormind 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: Ormind. MCP server URL:
https://app.ormind.ai/api/mcp. Authentication: OAuth. - Give it the ChatGPT Client IDUnder the OAuth settings, set the registration method to User-defined OAuth client and paste this into OAuth Client ID (leave the secret empty). The callback URL ChatGPT shows,
https://chatgpt.com/connector_platform_oauth_redirect, is already allowed. Tick I trust this application, then Create:Do not let ChatGPT register a client automatically: our sign-in service caps how many it keeps, and the connection would fail.OAuth Client ID for ChatGPTloading… - Sign inChatGPT sends you to the Ormind 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 Ormind. 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, Ormind 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 tokenOpen your connections in Ormind (also reachable from any dossier's overview, "Work on this dossier from your own AI" › Your token), then, under With Claude Code on your computer, generate your agent token.
- Paste the commandOrmind shows you the exact command. It looks like this:
claude mcp add --transport http ormind https://app.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: Ormind 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 dossier 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 dossier, 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 your 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 dossiers 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 › Ormind, Claude counts the interactive tools it found: 7 is right. Then look for the permission prompt to display the Ormind 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. |
| “Ormind” 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 dossier is missing | The assistant only sees dossiers 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 your 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.
Contact support