公開MCP — ログインなしで読める範囲
公開MCP — ログインなしで読める範囲
iknow.dev には 公開MCP（/mcp/public/{agentCode}）があり、ログインなしで パブリックアイノウ のナレッジを参照できます。
公開MCP とは
| 項目 | 内容 |
|---|---|
| エンドポイント | /mcp/public/{agentCode}（例: /mcp/public/iknow-navigator） |
| 認証 | 不要（匿名接続可） |
| 対象 | パブリック アイノウのみ（プライベートは 404） |
| レート制限 | 10 回/分（IP ベース。詳細は No.1.10） |
使えるツール（読取のみ・4種）
| ツール | 説明 |
|---|---|
search-knowledge |
ナレッジの検索と一覧（query を省略すると No 昇順の一覧、depth で階層を絞込） |
get-knowledge |
ナレッジ本文の取得（section=index で見出し目次、include でリンク・コメントも取得） |
get-reference |
アイノウ一覧・クイックスタート・ツールガイド・Markdown ガイド |
get-attachment |
ナレッジに添付された画像・ファイルの取得 |
全ツール一覧（認証MCP含む・全11種）
認証MCP（/mcp・/mcp/{agentCode}）では、読取に加え書込・管理系も利用できます。呼べるツールは 役割 で決まります（オーナー＝全ツール／メンバー＝読取4種＋add-comment／匿名＝読取4種のみ）。各ツールは標準の MCP アノテーション（読取は readOnlyHint、書込は destructiveHint）を宣言します。
| ツール | 区分 | 説明 | 必要権限 |
|---|---|---|---|
search-knowledge |
読取 | キーワード・意味（ベクトル）・ハイブリッド検索と一覧 | 匿名可（公開） |
get-knowledge |
読取 | ナレッジ本文・見出し目次・関連リンク・コメントを取得 | 匿名可（公開） |
get-reference |
読取 | アクセス可能なアイノウ一覧とツール・Markdown ガイド | 匿名可（公開） |
get-attachment |
読取 | 添付ファイル（画像等）の取得 | 匿名可（公開） |
add-comment |
書込 | ナレッジのセクションにコメントを追加 | メンバー以上 |
create-knowledge |
書込 | ナレッジを新規作成 | オーナー |
update-knowledge |
書込 | ナレッジ本文・タイトル・タグ・番号・関連リンクを更新 | オーナー |
append-knowledge |
書込 | 既存ナレッジの末尾（または指定セクション）に追記 | オーナー |
delete-knowledge |
書込 | ナレッジを削除（ソフトデリート） | オーナー |
create-attachment-upload-url |
書込 | 添付アップロード用の署名付き URL を発行（有効15分） | オーナー |
create-agent |
作成 | 新規アイノウを作成（非公開・作成者が単独オーナー） | ログインユーザー |
かつて存在した
list-knowledge/list-comments/update-knowledge-meta/query-json-rows/write-json-rowsは廃止されました。一覧はsearch-knowledge（query省略）、コメント取得はget-knowledgeのinclude=["comments"]、メタ更新はupdate-knowledgeのtitle/tags/no/link_to/unlink_fromに統合されています。テーブル型JSONの廃止（→ No.1.3）に伴い JSON 行操作ツールもなくなりました。
使えないツール（公開MCP）
- 書込系（
create-knowledge,update-knowledge,append-knowledge,delete-knowledge,create-attachment-upload-url）— ログイン必要 add-comment— ログイン必要（メンバー以上）create-agent— ログイン必要- 非公開アイノウ — アクセス不可（404）
通常MCP との違い
| 公開MCP | 認証MCP（オーケストレーション） | 認証MCP（個別） | |
|---|---|---|---|
| URL | /mcp/public/{agentCode} |
/mcp |
/mcp/{agentCode} |
| 認証 | 不要 | OAuth 必須 | OAuth 必須 |
| 対象 | パブリック 1 件のみ | 参加アイノウ全体 | 指定 1 件 |
| 書込 | × | 権限に応じて | 権限に応じて |
| レート | 10 回/分 | 30 回/分 | 30 回/分 |
オーケストレーション（
/mcp）では、まずget-reference name=agentsでアクセス可能なアイノウ一覧を取得し、選んだcodeを各ツールのagent_codeに渡します。サーバーは対象を記憶しないため、search-knowledgeとcreate-knowledgeでは毎回指定が必要です。
利用例
- iknow Navigator を匿名で Cursor から参照
- パブリックな技術ドキュメントを IDE 内で検索
- デモ・評価目的での試用
設定方法
Cursor 等の MCP クライアントで https://<ホスト>/mcp/public/<agentCode> をエンドポイントに指定します（例: https://iknow.dev/mcp/public/iknow-navigator）。OAuth 設定は不要です。
詳細手順は No.6.1 および公開ドキュメント /docs/mcp も参照してください。