What you get
- You ask Izumi from a tool you already use. You do not open a separate app.
- The tool sees only what you may see in Izumi, in all your companies. The connection carries your permissions, nothing more.
- Izumi does not write the answer for the tool. Izumi returns passages with source, link, author and freshness, and the AI tool writes the answer.
- Optional: the tool can propose a note. The note goes to the Review queue, and an editor of the domain approves or rejects it. Until then nobody can find it by search.
Two ways to connect
The server address is the address of your Izumi with
/mcp at the end. On the demo installation (invitation only) it is https://izumi.akiaconsulting.com/mcp.
OAuth needs an Izumi server with OAuth turned on. The administrator sets this up once, see the Installation tab.
Scopes
read: search and read documents. Always on.propose: propose notes that an editor reviews. It is ticked by default on the approval page and you can untick it. A token with onlyreadcan search but cannot propose.pushexists for the push API and is not used over MCP.
Pick your tool
ChatGPT
Add Izumi as a plugin, OAuth, no token.
Claude
claude.ai and Claude Desktop, one connector, one account.
Slack
Izumi in Slackbot. The steps are split between the Izumi admin, the Slack admin and every user.
Claude Code
Terminal and editor. OAuth or a personal token.
Other clients
Address and header for any MCP client. Not checked live.
Tools and example questions
The five tools the AI sees, errors and example questions.
Where you see and revoke connections
- In Izumi open My tokens and profile. All connections and tokens are in the Tokens section. An OAuth connection is a row marked Connected app, with the client name and address.
- Revoke ends the connection at once, without a confirmation. The client then asks you to connect again. The exception is Slackbot, see the Slack page.
- The client’s calls show in the Access log.
Limits
- 60 calls per minute per token. After that the tool returns the error
rate_limited. - Streamable HTTP only. A client that supports only local (stdio) servers does not work.
- A connection lasts at most 90 days. After that the client asks you to connect again.
Troubleshooting
- The tool says it has no Izumi tools: the connection is not on in that chat or it expired. See the page for your tool.
- The tool returns an error: see the table of errors on the page Tools and example questions.
- The connection was revoked and the tool does not offer to reconnect: connect it again following the page for that tool.