# Claude Code

> Connect Claude Code to Korala with the plugin or a single `claude mcp add` command.

Source: https://docs.korala.ai/ai-agents/claude-code

---

Two ways to connect: the plugin, or the server address on its own. Both sign in through your browser.

  Screenshots of Claude Code will be added after the public launch. The steps below follow Claude Code's current documentation (checked 2026-09-18); menu names can change.

## Plugin

The plugin adds the Korala server and a skill. The skill teaches Claude the drafting workflow and the draft link that needs no account.

1. Add the marketplace and install the plugin:

   ```text
   /plugin marketplace add korala-ai/claude-plugins
   /plugin install korala@korala
   ```

2. Run `/mcp`, choose **korala**, and sign in.
3. Approve the connection on Korala's consent page. See [Permissions and safety](https://docs.korala.ai/ai-agents/permissions).

## Direct

1. Add the server:

   ```bash
   claude mcp add --transport http korala https://api.korala.ai/mcp
   ```

2. Start a session, run `/mcp`, choose **korala**, and authenticate.
3. Approve the connection on Korala's consent page.

Check and remove:

```bash
claude mcp list
claude mcp remove korala
```

## Share the server with your team

Add `--scope project` and Claude Code writes `.mcp.json` in the repository root:

```bash
claude mcp add --transport http --scope project korala https://api.korala.ai/mcp
```

```json
{
  "mcpServers": {
    "korala": {
      "type": "http",
      "url": "https://api.korala.ai/mcp"
    }
  }
}
```

The file holds the address and no credentials. Each teammate signs in with their own Korala account.

## Headless use

Sign in once in an interactive session. After that, non-interactive runs reuse the connection:

```bash
claude -p "List my Korala documents that are pending" \
  --allowedTools "mcp__korala__*"
```

For CI machines where nobody can open a browser, use an [API key](https://docs.korala.ai/ai-agents/api-key).

## If Korala says it no longer recognizes the assistant

Claude Code remembers the registration it made with Korala. If that
registration is removed, the sign-in page says "Korala no longer recognizes
this assistant". Remove the server and add it again:

```sh
claude mcp remove korala
claude mcp add --transport http korala https://api.korala.ai/mcp
```