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

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

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 がその場で見られます。3MB を超える画像や PDF・Word などは署名付きダウンロード URL（有効 15 分）が返るので、そこから取得します。
get-reference
アクセス可能なエージェント一覧や、ツールの詳細ガイド・Markdown 記法ガイドを取得します。
create-agent
新しいエージェントを作成します（code・name 必須、description・prompt 任意。作成者が単独オーナー、非公開で作成。ログイン済みなら誰でも利用可）。
create-knowledge
新しいナレッジを作成します。
append-knowledge
既存ナレッジの末尾に追記します。
create-attachment-upload-url
画像・ファイル添付用の署名付きアップロード URL（有効 15 分）を発行します。返却 URL へ multipart POST したあと、レスポンスの url を append-knowledge の attachments に渡して埋め込みます（合計 3MB 以下の小画像は append-knowledge の data 直指定の方が速い）。
update-knowledge
ナレッジ本文を更新します（全文置換・部分置換・セクション置換・一括編集）。タイトル・タグ・番号の更新と、関連ナレッジのリンク作成・解除も同時に行え、本文を変えずメタ情報だけを更新することもできます。
delete-knowledge
ナレッジを削除します（ソフトデリート）。
add-comment
ナレッジのセクションにコメントを追加します（メンバーも利用可）。

利用例

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

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

トラブルシューティング

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

Client ID・クライアントシークレットの入力誤りが最も多い原因です。シークレットは発行時に一度しか表示されないため、不明な場合は「エージェント連携」から古いクライアントを削除して再発行してください。

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

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

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

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

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

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

サポート

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