Claude / Cursor 連携（MCP）ガイド

iknow.dev は MCP（Model Context Protocol）サーバーを提供しており、Claude や Cursor などの AI アシスタントからエージェントのナレッジを検索・取得・作成・更新できます。このページでは接続手順と利用できるツール、よくあるトラブルの対処方法を説明します。

iknow MCP とは

iknow MCP は、iknow.dev 上のエージェントに紐づくナレッジを AI アシスタントから直接操作するためのリモート MCP サーバーです。キーワード検索・意味検索によるナレッジの参照に加え、オーナー権限があればナレッジの作成・編集・削除も行えます。アクセス権限は Web 画面と同じで、エージェントごとのオーナー / メンバー / パブリックの役割に従います。

Claude への接続方法

Claude（Web / デスクトップ / モバイル）のカスタムコネクタとして接続します。

  1. iknow.dev にログインし、ナレッジエディターのヘッダー、またはマイページのエージェント設定にある「Claude / Cursor 連携」ボタンを開きます。
  2. 「Claudeへインストール」のリモート MCP サーバー URL をコピーします。
  3. Claude の 設定 → コネクタ から「カスタムコネクタを追加」を選び、コピーしたリモート MCP サーバー URL を入力して追加します。
  4. コネクタの「接続」をクリックすると iknow.dev の認可画面が開くので、内容を確認して承認します。
  5. チャットでコネクタを有効にすると、アクセス可能なエージェントのナレッジを Claude から利用できます。

OAuth クライアントは接続時に自動登録され、Claude のコールバック URL（claude.ai / claude.com の両方）が許可されています。

Cursor への接続方法

同じ「Claude / Cursor 連携」モーダルの「Cursorへインストール」をクリックすると、Cursor が起動してワンクリックで MCP サーバーが登録されます（認証情報は自動で設定されます）。

利用できるツール

参照系ツールはオーナー / メンバー / パブリックエージェントの匿名利用者が、書き込み系ツールはオーナー（コメント追加はメンバーも）が利用できます。ただし create-agent は既存エージェントの権限に依存せず、ログイン済みユーザーなら誰でも利用できます。すべてのツールは MCP 標準のアノテーション（参照系: readOnlyHint、書き込み系: destructiveHint）を宣言しています。

search-knowledge
ナレッジをキーワード・意味（ベクトル）・ハイブリッドで検索します。query を省略すると、エージェントのナレッジ一覧を番号順に取得します（タグ・階層での絞り込み可）。
get-knowledge
ナレッジ本文・関連ナレッジ・見出しアウトラインを取得します。include=["comments"] でセクションコメント一覧も同時に取得できます（comments_source="health_check" で絞り込み可。ヘルスチェック指摘の重複確認に利用）。
get-attachment
ナレッジ本文に埋め込まれた画像・ファイルを取得します。本文中の URL をそのまま渡すだけで、3MB 以下の添付は実体が結果に同梱されます。画像は AI がその場で見られ、テキスト（48KB 以下）は本文がそのまま届き、PDF や Office 文書はファイルとして受け取ります（Claude Code ではローカルに保存されます）。3MB を超えるファイルは署名付きダウンロード URL（有効 15 分）が返るので、そこから取得します。
get-reference
アクセス可能なエージェント一覧や、ツールの詳細ガイド・Markdown 記法ガイドを取得します。
create-agent
新しいエージェントを作成します（code・name 必須、description・prompt 任意。作成者が単独オーナー、非公開で作成。ログイン済みなら誰でも利用可）。
create-knowledge
新しいナレッジを作成します（タイトル・本文・タグ・番号・関連リンク）。数十 KB までの小ファイル添付を同時に埋め込むこともできます。
append-knowledge
既存ナレッジに追記します（末尾、または指定セクションの末尾・見出し直後）。添付はアップロード済みの URL か小ファイルの base64 データで渡すと、Markdown を自動生成して埋め込みます。
create-attachment-upload-url
画像・ファイル添付用の署名付きアップロード URL（有効 15 分）を発行します。返却 URL へ multipart POST したあと、レスポンスの url を append-knowledge の attachments に渡して埋め込みます。数十 KB までの小ファイルなら、アップロードせずに append-knowledge / create-knowledge の attachments に base64 の data を直接渡す方が簡単です。
update-knowledge
ナレッジ本文を更新します（全文置換・部分置換・セクション置換・一括編集）。タイトル・タグ・番号の更新と、関連ナレッジのリンク作成・解除も同時に行え、本文を変えずメタ情報だけを更新することもできます。
delete-knowledge
ナレッジを削除します（ソフトデリート）。
add-comment
ナレッジのセクションにコメントを追加します（メンバーも利用可）。

利用例

接続後、Claude のチャットで次のように依頼できます。

  • 「(エージェント名) のナレッジから『料金体系』に関する情報を検索して、要点をまとめて」 — ナレッジを検索し、本文を取得して要約します。
  • 「今日の打ち合わせの決定事項を、タグ『議事録』を付けて新しいナレッジとして登録して」 — 会話の内容からナレッジを作成します（オーナーのみ）。
  • 「(エージェント名) の議事録ナレッジに、今日の決定事項を追記して」 — 既存ナレッジの該当セクションへ追記します（オーナーのみ）。

トラブルシューティング

接続（OAuth 認可）に失敗する

Claude では OAuth クライアントが接続時に自動登録されるため、Client ID やシークレットを手で入力する必要はありません。認可画面が開かない、または承認後に失敗する場合は、Claude 側でコネクタを削除して追加し直してください。Cursor は「Cursorへインストール」をもう一度クリックすると新しい認証情報で再登録されます（古いクライアントは自動的に無効になります）。Copilot Studio など Client ID・シークレットを手で設定するクライアントでは入力誤りが最も多い原因です。シークレットは発行時に一度しか表示されないため、不明な場合はクライアントを再登録してください。

ツールが表示されない・書き込みでエラーになる

利用できるツールはエージェントでの役割によって異なります。書き込み系ツールはオーナーのみ（コメント追加はメンバー可）です。

「レートリミット超過」のエラーが返る

短時間に大量のツール呼び出しを行うと一時的に制限されます。時間をおいて再試行してください。

エージェントが見つからない（404）と言われる

プライベートエージェントはオーナー / メンバーのみアクセスできます。エージェントコードの綴りと、対象エージェントへの参加状況を確認してください。

サポート

解決しない場合は、下記までお問い合わせください。
contact@iknow.dev