Cursor / Claude から使う（MCP 連携）
Cursor / Claude から使う（MCP 連携）
IDEやAIアシスタントからiknow.devのナレッジを操作する方法です。
連携の入口は チャット画面 または ナレッジエディター のヘッダーにある 「エージェント連携」ボタン です（クリックするとモーダルが開きます）。
セットアップ（Cursor）
- ヘッダーの 「エージェント連携」 を開く
- 「Cursorへインストール」 をクリック
- Cursor が起動し、ワンクリックで
mcp.jsonに登録されます（認証情報も自動で設定）
OAuthクライアントは 1ユーザーにつき1つ です。もう一度インストールすると新しい認証情報に置き換わり、以前のCursor登録は無効になります。
セットアップ（Claude）
- ヘッダーの 「エージェント連携」 を開く
- 「Claudeへインストール」 の MCPサーバーURL をコピー
- Claude の 設定 → コネクタ → 「カスタムコネクタを追加」 にURLを貼り付けて追加
- コネクタの「接続」を押すと iknow.dev の認可画面が開くので、承認します
Client ID・Secret の手動入力は不要です（接続時にクライアントが自動で登録されます）。
MCPの種類
| 種類 | URL | 認証 | 権限 |
|---|---|---|---|
| オーケストレーション | /mcp |
OAuth必須 | 参加アイノウに応じた権限 |
| 個別アイノウ | /mcp/{agentCode} |
OAuth必須 | アイノウ単位 |
| 公開MCP | /mcp/public/{agentCode} |
不要 | パブリックアイノウの読取のみ |
主なツール
以下は 代表的な例 です。公開 MCP の読取 6 ツール等の一覧は No.6.4 を参照してください。
search-knowledge: ナレッジ検索（キーワード/意味/ハイブリッド）get-knowledge: ナレッジ取得create-knowledge/update-knowledge: ナレッジ作成・更新（オーナー）add-comment: セクションコメント（メンバー以上）create-agent: 新規アイノウ作成（OAuth 認証必須。非公開・単言語で作成され、呼び出した本人が単独オーナー。code/name必須、promptは最大 2,000 文字）
プロンプト例
接続後は、AIアシスタントに次のように指示できます。
- 「（アイノウ名）のナレッジで『料金』を検索して要点をまとめて」— ナレッジを検索・取得して要約します。
- 「今日の会議の決定事項を、タグ『議事録』を付けて新しいナレッジに登録して」— 会話からナレッジを作成します（オーナーのみ）。
- 「課題管理のナレッジから、ステータスが未完了の行を一覧にして」— テーブル形式JSONの行を条件で絞り込みます。
誤って上書きしたとき
MCP の update-knowledge などで意図せずナレッジを書き換えてしまっても、エディターの 変更履歴 から編集前の版に戻せます（No.4.8）。重要なナレッジは 読み取り専用（No.4.9）にすると MCP からの書込も拒否できます。
公開ドキュメント
詳細手順は /docs/mcp ページも参照してください。