MCP

Model Context Protocolサーバーは、AIアシスタント向けのManagement APIです。すべての操作はツールとして提供され、ツール名はManagement APIリファレンスにおける各操作のoperationId（例：posts_createやsite_publish）と一致します。権限、エラー、レート制限、およびドラフトの挙動は、REST API経由の場合と完全に同一です。

コネクタ対応のアシスタント

Claude、ChatGPT、および組み込みコネクタを備えたその他のアシスタントはOAuthを使用するため、ユーザーがトークンを直接扱う必要はありません。

1. アシスタントのコネクタ設定にて、サーバーURL https://app.kanorio.com/api/mcp を指定してカスタムコネクタを追加します。URLをチャット欄に貼り付けないでください。
2. アシスタントが同意ページを開いたらKanorioにサインインし、対象のサイトと権限を選択して承認します。

アシスタントは https://app.kanorio.com/.well-known/oauth-protected-resource からその他の情報を自動的に検出します。Kanorioは動的クライアント登録およびクライアントIDメタデータドキュメントをサポートしています。承認済みのアプリは、アカウント設定からいつでも確認および取り消しが可能です。

キーを使用するコーディングアシスタント

Cursor、Claude Code、Codex、Gemini CLI、Windsurf、VS Codeはパーソナルアクセストークンを使用します。アカウント設定 › APIアクセスからトークンを作成してください。ツールを選択すると、トークンが入力済みの設定情報がKanorioに表示されます。

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "kanorio": {
      "url": "https://app.kanorio.com/api/mcp",
      "headers": { "Authorization": "Bearer knr_pat_..." }
    }
  }
}

Claude Code:

claude mcp add --transport http kanorio https://app.kanorio.com/api/mcp --header "Authorization: Bearer knr_pat_..."

VS Code (.vscode/mcp.json):

{
  "servers": {
    "kanorio": {
      "type": "http",
      "url": "https://app.kanorio.com/api/mcp",
      "headers": { "Authorization": "Bearer knr_pat_..." }
    }
  }
}

Codex (~/.codex/config.toml):

[mcp_servers.kanorio]
url = "https://app.kanorio.com/api/mcp"
http_headers = { "Authorization" = "Bearer knr_pat_..." }

トークンを含むファイルは、バージョン管理システムに含めないようにしてください。

ツールの挙動

• トークンの権限範囲内での動作: tools/list は、トークンの権限外にあるツールを非表示にします。auth_whoami を呼び出すと、トークンの権限および隠された機能を確認できます。
• 公開までのドラフト: コンテンツの作成操作は、site_publish、posts_publish などの公開ツールが実行されるまでドラフト状態を維持します。
• 構造化された結果: 各ツールは、操作のレスポンススキーマに準拠した構造化コンテンツを返します。リスト形式の場合はページネーションエンベロープを使用します。
• エラー: 呼び出しに失敗した場合、isError とともにエラーエンベロープが返されます。FORBIDDEN、プラン制限、モードエラーはバグではなく制限事項です。details にユーザーが修正すべき内容が記載されています。
• 冪等性: 冪等性をサポートする作成操作ツールは、idempotencyKey 引数を受け取ります。冪等性を参照してください。
• 非推奨: 非推奨となったツールの説明文は [Deprecated, removed after …; use …] で始まります。

サーバーバージョン

サーバーはセマンティックバージョニングを採用しており、serverInfo.version および https://app.kanorio.com/.well-known/mcp/server.json で確認できます。変更履歴には各バージョンの変更点が記録されています。メジャーバージョンが更新された場合、既存のツールの挙動が変更される可能性があるため、ツールスキーマをキャッシュしているクライアントは更新を行ってください。