公開MCP — ログインなしで読める範囲
公開MCP — ログインなしで読める範囲
iknow.dev には 公開MCP（/mcp/public/{agentCode}）があり、ログインなしで パブリックアイノウ のナレッジを参照できます。
公開MCP とは
| 項目 | 内容 |
|---|---|
| エンドポイント | /mcp/public/{agentCode}（例: /mcp/public/iknow-navigator） |
| 認証 | 不要（匿名接続可） |
| 対象 | パブリック アイノウのみ（プライベートは 404） |
| レート制限 | 10 回/分（IP ベース。詳細は No.1.10） |
使えるツール（読取のみ）
| ツール | 説明 |
|---|---|
search-knowledge |
キーワード・意味検索 |
get-knowledge |
ナレッジ本文取得 |
list-knowledge |
ナレッジ一覧 |
get-reference |
アイノウ情報・ガイド |
list-comments |
セクションコメント一覧 |
query-json-rows |
テーブル JSON 読取 |
全ツール一覧（認証MCP含む）
認証MCP（/mcp・/mcp/{agentCode}）では、読取に加え書込・管理系も利用できます。読取系はオーナー・メンバー・公開アイノウの匿名ユーザーが利用可。書込系はオーナー権限が必要（add-comment のみメンバー以上可）。create-agent はログインユーザーなら誰でも可。各ツールは標準の MCP アノテーション（読取は readOnlyHint、書込は destructiveHint）を宣言します。
| ツール | 区分 | 説明 | 必要権限 |
|---|---|---|---|
search-knowledge |
読取 | キーワード・意味（ベクトル）・ハイブリッド検索 | 匿名可（公開） |
get-knowledge |
読取 | ナレッジ本文・関連リンク・見出し目次を取得 | 匿名可（公開） |
list-knowledge |
読取 | ナレッジ一覧（タグ・階層深さで絞込） | 匿名可（公開） |
query-json-rows |
読取 | テーブル形式JSONの行を絞込・整列・集計 | 匿名可（公開） |
get-reference |
読取 | アクセス可能なアイノウ一覧とツール・Markdownガイド | 匿名可（公開） |
list-comments |
読取 | セクションコメント一覧（見出し・健診で絞込） | 匿名可（公開） |
create-knowledge |
書込 | ナレッジを新規作成 | オーナー |
append-knowledge |
書込 | 既存ナレッジの末尾に追記 | オーナー |
update-knowledge |
書込 | ナレッジ本文を更新（全面/anchor/section/batch） | オーナー |
update-knowledge-meta |
書込 | タイトル・タグ・番号の更新、関連リンクの増減 | オーナー |
write-json-rows |
書込 | テーブル形式JSONの行を追加・更新・削除 | オーナー |
delete-knowledge |
書込 | ナレッジを削除（ソフトデリート） | オーナー |
add-comment |
書込 | ナレッジのセクションにコメントを追加 | メンバー以上 |
create-agent |
作成 | 新規アイノウを作成（非公開・作成者が単独オーナー） | ログインユーザー |
使えないツール
- 書込系（
create-knowledge,update-knowledge等）— ログイン必要 - 非公開アイノウ — アクセス不可（404）
create-agent— ログイン必要add-comment— ログイン必要（メンバー以上）
通常MCP との違い
| 公開MCP | 認証MCP（オーケストレーション） | 認証MCP（個別） | |
|---|---|---|---|
| URL | /mcp/public/{agentCode} |
/mcp |
/mcp/{agentCode} |
| 認証 | 不要 | OAuth 必須 | OAuth 必須 |
| 対象 | パブリック 1 件のみ | 参加アイノウ全体 | 指定 1 件 |
| 書込 | × | オーナー可 | 権限に応じて |
| レート | 10 回/分 | 30 回/分 | 30 回/分 |
利用例
- iknow Navigator を匿名で Cursor から参照
- パブリックな技術ドキュメントを IDE 内で検索
- デモ・評価目的での試用
設定方法
Cursor 等の MCP クライアントで https://<ホスト>/mcp/public/<agentCode> をエンドポイントに指定します（例: https://iknow.dev/mcp/public/iknow-navigator）。OAuth 設定は不要です。
詳細手順は No.6.1 および公開ドキュメント /docs/mcp も参照してください。