Connect an AI Assistant
Audience: Any Kizen user connecting an AI assistant.
Purpose: Connect a supported AI assistant to Kizen and confirm it can read your Knowledge Catalogs.
Warning: Connecting an assistant grants it read access to your Knowledge Catalogs under your own permissions. Only connect assistants and clients you trust.
Overview
You can connect an external AI assistant to Kizen through the Kizen MCP server so it can search your Knowledge Catalogs on your behalf. Connect your client using OAuth, or use the API-key method as an alternative for testing.
Before You Begin
Make sure you have:
An active Kizen account with View permission on the catalogs you want the assistant to reach.
A supported MCP client: the Claude app or Claude.ai, Claude Code, ChatGPT (via the Codex desktop app), or Gemini (via the Antigravity app).
The MCP server endpoint URL. For more information, see How the MCP Server Works.
Connect with Claude (Custom MCP Connector)
Whether you can add a custom MCP connector depends on your Claude account. On a personal account you can add your own. In a managed Team or Enterprise workspace, an administrator controls whether members can add custom connectors. If it's disabled, you'll see your existing connectors but no Add custom connector option, and an owner must add it for the workspace.
Open Connector Settings. In Claude, go to Settings, then Connectors.
Add the Kizen MCP Connector. Select Add custom connector, paste the MCP server URL: https://app.go.kizen.com/api/mcp/readonly/, and select Add. You don't need to enter a token because Kizen handles sign-in through OAuth.
Connect and Authorize. Select Connect. Claude opens Kizen sign-in in your browser. Sign in, choose the business you want, and authorize. When you return, the MCP connector lists your catalogs. You can confirm by asking Claude to list the catalogs on the Kizen MCP.
Connect with Claude Code (CLI)
Add the server from the command line, then complete the browser sign-in when prompted:
Sign in, select a business, and approve.
Connect with ChatGPT (Codex Desktop App)
MCP can't be configured in ChatGPT on the web. Instead, use the Codex desktop app.
Open MCP settings. In the Codex app, go to Settings > Integrations & MCP and select Add server.
Add the Kizen server. Give it a name (for example, "Kizen"), choose Streamable HTTP as the type, paste the MCP server URL, and Save.
Authenticate. Codex prompts you to Authenticate. Complete the OAuth sign-in in your browser, and then, in a new chat, confirm by asking Codex to list the catalogs on the Kizen MCP.
Connect with Gemini (Antigravity App)
Configure MCP in the Antigravity app (not the Gemini browser). Antigravity's Add MCP screen lists published partner connectors. To add a custom server, edit the MCP config file.
Open the MCP config. Go to Settings > Customizations > Installed MCP Servers > Open MCP config.
Add the Kizen server. Add an entry using the
serverUrlkey:Authorize. Antigravity signs in with OAuth (PKCE) and a local callback (port 8080). Authorize in the browser when prompted. The catalogs load. You can also let the agent sign in for you. For example: Add a custom MCP named Kizen at https://app.go.kizen.com/api/mcp/readonly/ and authenticate with PKCE.
What's Next
Once you're connected, see MCP Tools for what each tool does, or revisit Build with MCP for how the server and authentication work.
Last updated
Was this helpful?