Cursor / Claude から使う（MCP 連携）

Cursor / Claude から使う（MCP 連携）

IDEやAIアシスタントからiknow.devのナレッジを操作する方法です。

連携の入口は チャット画面 または ナレッジエディター のヘッダーにある 「エージェント連携」ボタン です（クリックするとモーダルが開きます）。

セットアップ（Cursor）

1. ヘッダーの 「エージェント連携」 を開く
2. 「Cursorへインストール」 をクリック
3. Cursor が起動し、ワンクリックで mcp.json に登録されます（認証情報も自動で設定）

OAuthクライアントは 1ユーザーにつき1つ です。もう一度インストールすると新しい認証情報に置き換わり、以前のCursor登録は無効になります。

セットアップ（Claude）

iknow MCP は Claude の 公式コネクタ になりました。MCPサーバーURL のコピー・貼り付けは不要です。

1. Claude の 設定 → コネクタ → コネクタディレクトリ を開く
2. 「iknow」 を検索し、「接続」 をクリック
3. iknow.dev の認可画面が開くので、承認します

MCPサーバーURL・Client ID・Secret の手動入力はいずれも不要です。

個別アイノウMCP（/mcp/{agentCode}）と 公開MCP（/mcp/public/{agentCode}）を Claude で使う場合は、従来どおり 設定 → コネクタ → 「カスタムコネクタを追加」 に URL を貼り付けて追加します。公式コネクタになったのはオーケストレーション（/mcp）のみです。

MCPの種類

主なツール

以下は 代表的な例 です。公開 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 からの書込も拒否できます。