# BrainLink を AI につなぐ手順（このファイルを AI にそのまま渡してください）

> **AI へ**: これは BrainLink の利用者があなたに渡した接続手順書です。
> 以下を**順番に、1 ステップずつ**案内してください。利用者は技術者とは限りません。
> 専門用語を使うときは短く言い換えを添え、**次に何をすればよいかを毎回1つだけ**示してください。
> 途中で分からなくなったら「最後のつまずき表」を見てください。
>
> 🔴 **あなた（AI）がやってはいけないこと**: 利用者の鍵を復唱しない・要約に含めない・
> ファイルに書き出さない。鍵は利用者の端末の中だけに置きます。

---

## これは何ですか

BrainLink に貯まったご自分の記録（会議の要点、メモ、名刺、不具合チケット）を、
お使いの AI から**読めるようにする**ための接続です。

- **読むだけです。** AI が BrainLink の中身を書き換えることはできません。
- **渡す範囲はご自分で選べます**（既定では「会議」だけです）。
- ⚠ 渡したあと、その AI が受け取った内容をどう扱うかは、その AI の提供元の規約と設定によります。
  BrainLink 側では決められません。

---

## 対応している AI（2026-09-10 現在）

| AI | いま使えるか |
|---|---|
| **Claude Code**（ターミナルで動くもの） | ✅ **使えます**（下の手順） |
| ChatGPT（ブラウザ版） | 🔴 **まだ使えません**。準備中です（下の「ChatGPT をお使いの方へ」） |
| Claude Desktop / claude.ai | 🔴 まだです（ChatGPT と同じ準備が要ります） |

---

## Claude Code につなぐ（3 分）

### ① 接続を発行する

1. BrainLink にログインします（パソコンのブラウザ）
2. **設定 → AI 連携（MCP）** を開きます
3. 渡す範囲を選びます。**はじめは「会議」だけのままで大丈夫です**（あとで増やせます）
4. **「接続を発行する」** を押します

すると、次のような**1 行**が表示されます。

```
claude mcp add --transport http brainlink https://…/api/mcp/v1 \
  --header "Authorization: Bearer <あなた専用の鍵>"
```

> 🔴 **この鍵は 1 回しか表示されません。** BrainLink 側にも残っていないので、
> 見失ったときは「無効にする → もう一度発行する」でやり直してください。
> 鍵は**人に渡さないでください**（渡した人はあなたの記録を読めます）。

### ② ターミナルに貼る

表示された 1 行を**そのままコピーして**、ターミナルに貼って Enter を押します。

### ③ つながったか確かめる

Claude Code で次を打ちます。

```
/mcp
```

`brainlink` が一覧に出れば成功です。試しにこう聞いてみてください。

```
先週の会議で決まったことを教えて
```

### 設定ファイルに書きたい場合（②の代わり）

プロジェクトの `.mcp.json` に、発行画面の JSON をそのまま貼っても同じです。

---

## ChatGPT をお使いの方へ

🔴 **いまは接続できません。** 鍵を ChatGPT のどこかの欄に貼っても繋がりません。**貼らないでください。**

理由: ChatGPT のコネクタ追加画面には、**この鍵を貼る欄がありません**
（認証の選択肢が「OAuth」「認証なし」「混合」の 3 つだけで、任意の項目を足せません）。

いま **OAuth** という方式の対応を進めています。できあがると、
**鍵そのものが要らなくなり**、ChatGPT の画面から BrainLink にログインするだけになります。
このページで改めてご案内します。

---

## つまずき表

| 出たもの / 症状 | 意味 | どうするか |
|---|---|---|
| `401` / 認証エラー | 鍵が違う、または無効にした | 発行画面でもう一度発行する |
| `403` | 渡す範囲に入っていない種類を読もうとした | 発行画面で範囲を増やす（増やしたら再接続） |
| `429` | 短い時間に呼びすぎ | 1 分ほど待つ |
| `503` | BrainLink 側の一時的な不調 | しばらく待ってやり直す |
| `404` | この機能がまだ開いていない | BrainLink 側の準備待ちです |
| `/mcp` に出てこない | 貼った行が途中で切れた | 発行画面からコピーし直す（`\` の折り返しごと貼る） |
| 「名刺が 300 件ありますが内容が読めません」 | **仕様です** | 名刺は第三者の個人情報なので、**本文は渡していません**（お名前と会社名だけ）。会社も、ご自分で書いた「メモ」だけです |
| 「記録が見つかりません」と言われる | 渡す範囲に入っていない可能性 | 発行画面で範囲を確認する。AI に `brainlink_list_kinds` を実行してもらうと、いま読める種類と件数が出ます |

**鍵をコピーするとき、前後に空白や改行が混ざっても大丈夫です**（BrainLink 側で取り除きます）。

---

## 渡すのをやめたいとき

BrainLink の **設定 → AI 連携（MCP）** で、その接続を **「無効にする」** を押してください。
その瞬間から、その鍵では何も読めなくなります。

⚠ **BrainLink のパスワードを変えても、この接続は切れません**（別々の仕組みです）。
外部 AI との接続を切りたいときは、上の「無効にする」を使ってください。