# MCP

> KanorioのリモートMCPサーバーを通じて、Claude、ChatGPT、CursorなどのアシスタントをManagement APIに接続します。

> Markdown version of https://kanorio.com/ja/developers/mcp. Append `.md` to any developer docs URL for this format. Index: https://kanorio.com/llms.txt · MCP: https://app.kanorio.com/api/mcp
>
> Translated from the English original: https://kanorio.com/en/developers/mcp.md

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

|  |  |
|---|---|
| サーバーURL | `https://app.kanorio.com/api/mcp` |
| トランスポート | ストリーミングHTTP |
| 認証 | OAuth 2.1、またはBearer形式のパーソナルアクセストークンもしくはサービスアカウントトークン |
| レジストリ名 | `com.kanorio/kanorio` |

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

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アクセス](https://app.kanorio.com/account/api-access)からトークンを作成してください。ツールを選択すると、トークンが入力済みの設定情報がKanorioに表示されます。

**Cursor** (`.cursor/mcp.json`):

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

**Claude Code:**

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

**VS Code** (`.vscode/mcp.json`):

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

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

```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` などの公開ツールが実行されるまでドラフト状態を維持します。
- **構造化された結果:** 各ツールは、操作のレスポンススキーマに準拠した構造化コンテンツを返します。リスト形式の場合は[ページネーションエンベロープ](https://kanorio.com/ja/developers/basics/pagination)を使用します。
- **エラー:** 呼び出しに失敗した場合、`isError` とともに[エラーエンベロープ](https://kanorio.com/ja/developers/basics/errors)が返されます。`FORBIDDEN`、プラン制限、モードエラーはバグではなく制限事項です。`details` にユーザーが修正すべき内容が記載されています。
- **冪等性:** 冪等性をサポートする作成操作ツールは、`idempotencyKey` 引数を受け取ります。[冪等性](https://kanorio.com/ja/developers/basics/idempotency)を参照してください。
- **非推奨:** 非推奨となったツールの説明文は `[Deprecated, removed after …; use …]` で始まります。

## サーバーバージョン

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