# Claudeと接続する

KafkaiはWeb版のclaude.ai、Claude Desktopアプリ、Claude Code、Web版Claude Code（claude.ai/code）のいずれからも利用できます。サーバーURLは共通です。

```
https://kafkai.com/mcp
```

カスタムコネクタはclaude.aiのすべてのプランで利用できます（無料プランは1つまで）。TeamプランとEnterpriseプランでは、先に組織のオーナーがコネクタを追加します（後述）。Anthropicはメニュー構成を変更することがあります。手順が画面と一致しない場合はClaudeの設定で「コネクタ」を検索します。

## claude.aiとClaude Desktop

### 1. コネクタの一覧を開く

**設定**を開きます。**カスタマイズ**の**コネクタ**を選択し、右上の**追加**を選択します。

<img src="https://kafkai.com/static/images/docs/connect/claude-01-connectors-ja.webp" alt="Claudeの設定画面。カスタマイズのコネクタが選択され、右上の追加ボタンが枠で囲まれている" width="800" loading="lazy">

### 2. 名前とサーバーURLを入力する

名前（例：`Kafkai MCP サービス`）とサーバーURL `https://kafkai.com/mcp` を入力し、**続ける**を選択します。

<img src="https://kafkai.com/static/images/docs/connect/claude-02-add-custom-connector-ja.webp" alt="カスタムコネクタを追加する画面。Kafkaiの名前とサーバーURLが入力されている" width="800" loading="lazy">

### 3. 認証の設定を確認する

ClaudeがKafkaiサーバーから認証の設定を読み取り、**検出済み**と表示します。認証は**今すぐサインイン**、OAuthクライアントは**自動的に登録**です。どちらも変更せず、**追加**を選択します。クライアントIDやシークレットの入力は不要です。

<img src="https://kafkai.com/static/images/docs/connect/claude-03-authentication-ja.webp" alt="カスタムコネクタを追加する画面の2ページ目。今すぐサインインと自動的に登録が検出済みになっており、追加ボタンがある" width="480" loading="lazy">

### 4. 接続する

コネクタの画面が開き、まだ接続されていないと表示されます。**連携**を選択します。

<img src="https://kafkai.com/static/images/docs/connect/claude-04-connect-ja.webp" alt="ClaudeのKafkaiコネクタ画面。サーバーURLと連携ボタンが表示されている" width="800" loading="lazy">

### 5. アクセスを許可する

Kafkaiの画面が開き、ClaudeがKafkaiアカウントへのアクセスを求めていると表示されます。サインインを求められたらサインインしてから、**許可**を選択します。

<img src="https://kafkai.com/static/images/docs/connect/claude-05-authorize.webp" alt="Kafkaiのアプリケーション認可画面。Claudeに許可される操作の一覧と、許可・拒否のボタンがある（英語表示）" width="800" loading="lazy">

### 6. ツールの使用タイミングを決める

コネクタの画面に戻ると、**ツールの権限**にKafkaiの全ツールが表示されます。初期設定の**承認が必要**では、Claudeはツールを呼び出すたびに確認を求めます。分析を最後まで中断なく進めるには、一覧の上にあるドロップダウンを**常に許可**にします。ツールごとに個別に設定することもできます。

Kafkaiの削除ツールは、まずプレビューを返します。確認済みの2回目の呼び出しで初めて削除します。そのため、**常に許可**にしても、Claudeがプロジェクトや競合サイトを1回の操作で削除することはありません。

<img src="https://kafkai.com/static/images/docs/connect/claude-06-always-allow-ja.webp" alt="Kafkaiコネクタの画面。ツールの権限がすべて常に許可になっている" width="800" loading="lazy">

これで設定は完了です。以降の登録とトークンの更新はClaudeが自動で処理します。チャットでは、**＋**メニューの**コネクタ**からKafkaiを有効にします。

Claude Desktopはclaude.aiのコネクタを共有するため、追加の設定は不要です。

### TeamプランとEnterpriseプラン

メンバー自身ではカスタムコネクタを追加できません。オーナーまたは管理者が1回だけ追加します。

1. **組織設定**を開き、**コネクタ**を選択します。
2. **追加**を選択し、**カスタム**にカーソルを合わせて**Web**を選択します。
3. 上記のサーバーURLを入力し、**追加**を選択します。

各メンバーは**カスタマイズ**の**コネクタ**でKafkaiを探し、**連携**を選択して自分のKafkaiアカウントでサインインします。

## Web版Claude Code

[claude.ai/code](https://claude.ai/code)のセッションにはclaude.aiアカウントのコネクタがそのまま引き継がれます。上記の手順でclaude.aiにKafkaiを追加すれば、以降の新しいセッションで利用できます。セッション内での設定は不要で、`claude mcp add` も使いません。

## ターミナルのClaude Code

claude.aiアカウントでClaude Codeにサインインしている場合、claude.aiに追加したコネクタが自動で読み込まれます。`/mcp` で確認できます。それ以外の場合（APIキーで利用している場合など）は、ターミナルからサーバーを追加します。

```
claude mcp add --transport http kafkai https://kafkai.com/mcp
```

このコマンドは現在のプロジェクトディレクトリにサーバーを登録します。すべてのプロジェクトで使うには `--scope user` を付けます。

Claude Codeのセッション内で `/mcp` を実行し、認証の案内に従います。またはターミナルで `claude mcp login kafkai` を実行します。ブラウザに同じサインイン画面が表示されるので、承認してターミナルに戻ります。ブラウザのないマシンでは、`claude mcp login kafkai --no-browser` を実行するとサインインURLが表示されるので、別の端末で開きます。

## 接続を確認する

Claudeに次のように質問します。

> Kafkaiのプロジェクトを一覧して。

接続できていれば、Claudeが `kafkai_list_projects` を呼び出し、プロジェクトの一覧を表示します。プロジェクトが未作成の場合は、空の一覧が返ります。その場合は[はじめに](https://kafkai.com/ja/docs/getting-started/)に進み、最初のプロジェクトを作成します。プロジェクトを作成したあとの質問例は、[プロンプト例](https://kafkai.com/ja/prompts/)をご覧ください。

## データをモデルの学習に使わせない

ClaudeがKafkaiから読み取るデータ（キーワード、競合サイト、順位）は、Claudeの学習設定の対象になります。モデルの学習に使われないようにするには、**設定**の**プライバシー**を開き、**AIモデルの改善に協力する**をオフにします。この設定はclaude.aiアカウント全体に適用されるため、Claude DesktopとClaude Codeにも有効です。

<img src="https://kafkai.com/static/images/docs/connect/claude-training-off-ja.webp" alt="Claudeの設定画面。プライバシーが選択され、AIモデルの改善に協力する設定がオフになっている" width="640" loading="lazy">

![Kafkaiに接続済み](https://kafkai.com/static/images/docs/connect-claude/welcome.png)

## 接続を解除する

**カスタマイズ**の**コネクタ**からKafkaiのコネクタを開き、**切断する**を選択します（Claude Codeでは `claude mcp remove kafkai` を実行します）。アクセストークンの有効期間は短いため、切断したコネクタはまもなく利用できなくなります。Kafkai側で失効が必要な場合は[お問い合わせ](https://kafkai.com/ja/contact/)ください。
