> For the complete documentation index, see [llms.txt](https://developer.kizen.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.kizen.com/docs/developers/build-with-the-mcp/connect-an-ai-assistant.md).

# Connect an AI Assistant

Step-by-step guide to connecting an external AI assistant to your Kizen Knowledge Catalogs over MCP using OAuth or API-key authentication.

{% hint style="success" %}
**Audience:** Any Kizen user connecting an AI assistant.

**Purpose:** Connect a supported AI assistant to Kizen and confirm it can read your Knowledge Catalogs.
{% endhint %}

{% hint style="warning" %}
**Warning:** Connecting an assistant grants it read access to your Knowledge Catalogs under your own permissions. Only connect assistants and clients you trust.
{% endhint %}

## Overview

You can connect an external AI assistant to <code class="expression">space.vars.Kizen\_company\_name</code> through the <code class="expression">space.vars.Kizen\_company\_name</code> 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 <code class="expression">space.vars.Kizen\_company\_name</code> 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](https://developer.kizen.com/docs/developers/build-with-the-mcp#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.

1. **Open Connector Settings**. In Claude, go to **Settings**, then **Connectors**.
2. **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 <code class="expression">space.vars.Kizen\_company\_name</code> handles sign-in through OAuth.&#x20;
3. **Connect and Authorize**. Select **Connect**. Claude opens <code class="expression">space.vars.Kizen\_company\_name</code> 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 <code class="expression">space.vars.Kizen\_company\_name</code> MCP.

***

## Connect with Claude Code (CLI)

Add the server from the command line, then complete the browser sign-in when prompted:

```
claude mcp add --transport http kizen-mcp https://app.go.kizen.com/api/mcp/readonly/ --scope user
```

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.

1. **Open MCP settings**. In the Codex app, go to **Settings** > **Integrations & MCP** and select **Add** server.
2. **Add the Kizen server**. Give it a name (for example, "<code class="expression">space.vars.Kizen\_company\_name</code>"), choose **Streamable HTTP** as the type, paste the MCP server URL, and **Save**.
3. **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 <code class="expression">space.vars.Kizen\_company\_name</code> 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.

1. **Open the MCP config**. Go to **Settings** > **Customizations** > **Installed MCP Servers** > Open **MCP config**.
2. **Add the Kizen server**. Add an entry using the `serverUrl` key:

   ```
   { "mcpServers": { "kizen": { "serverUrl": "https://app.go.kizen.com/api/mcp/readonly" } } } 
   ```
3. **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 <code class="expression">space.vars.Kizen\_company\_name</code> at <https://app.go.kizen.com/api/mcp/readonly/> and authenticate with PKCE.

***

## What's Next

Once you're connected, see [MCP Tools](/docs/developers/build-with-the-mcp/mcp-tools.md) for what each tool does, or revisit [Build with MCP](/docs/developers/build-with-the-mcp.md) for how the server and authentication work.

<details>

<summary><strong>Related Topics</strong></summary>

* [Build with MCP](/docs/developers/build-with-the-mcp.md)
* [Authentication](/docs/developers/authentication.md)
* [Generate API Credentials](/docs/developers/building-with-apis/generating-api-credentials.md)
* [Permissions](/docs/settings-and-administration/permissions.md)

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developer.kizen.com/docs/developers/build-with-the-mcp/connect-an-ai-assistant.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.