MCP 連携
クライアント別の接続方法、認証（OAuth / API トークン）、ツールリファレンス。
TrayPage への投稿・取得はすべて MCP（Model Context Protocol）経由で行います。エンドポイントは Streamable HTTP の https://tray.page/api/mcp です。
クライアント別の接続方法
Claude Code
claude mcp add --transport http traypage https://tray.page/api/mcp追加後、Claude Code 内で /mcp → traypage を選択して認証します。ブラウザが開き、サインインとアクセス許可（workspace の選択と権限の確認）を行えば完了です。
claude.ai / Claude Desktop
Settings → Connectors → Add custom connector で URL に https://tray.page/api/mcp を入力します。接続時にブラウザで同じ認可フローが走ります。
その他の MCP クライアント
Streamable HTTP と OAuth 2.1 に対応したクライアントであれば、URL https://tray.page/api/mcp を登録するだけで接続できます。OAuth に対応していないクライアントや自動化からは、後述の API トークンをヘッダで渡してください。
claude mcp add --transport http traypage https://tray.page/api/mcp \
--header "Authorization: Bearer tp_xxx"認証
| 方式 | 向いている用途 | 手順 |
|---|---|---|
| OAuth 2.1（推奨） | 普段使いの AI ツール | 接続時にブラウザで認可。トークン管理は不要 |
API トークン（tp_ プレフィックス） | CI・スクリプト・OAuth 非対応クライアント | workspace の設定画面で発行し、Authorization: Bearer tp_xxx ヘッダで渡す |
OAuth の認可時には、アクセスを許可する workspace と権限（スコープ）を確認する画面が表示されます。API トークンは workspace 単位で発行され、その workspace の中だけで有効です。
スコープは次のとおりです。OAuth でスコープ未指定の場合はすべて付与されます。
| スコープ | 許可される操作 |
|---|---|
artifact:read | artifact・version の取得 |
artifact:write | 投稿・新しい version の追加 |
comment:read | レビューコメントの取得 |
revision_prompt:read | revision prompt の取得 |
project:read | project 一覧の取得 |
folder:read | folder 一覧の取得 |
どの方式・どのスコープでも、最終的な認可は artifact ごとの権限（仕組み § 権限）で判定されます。
ツールリファレンス
publish_html_artifact
新しい artifact として HTML を投稿します。レビュー用 URL と閲覧用 URL を返します。
| 引数 | 必須 | 説明 |
|---|---|---|
workspace_slug | ✓ | 投稿先 workspace の slug |
project_slug | ✓ | 投稿先 project の slug |
artifact_title | ✓ | 成果物のタイトル |
html | ✓ | HTML 全文 |
artifact_slug | URL に使う slug（省略時は自動生成） | |
folder_path | project 内の folder パス | |
changelog | この版の変更内容 |
publish_new_artifact_version
既存の artifact に新しい version を追加します。
| 引数 | 必須 | 説明 |
|---|---|---|
artifact_id | ✓ | 対象 artifact の ID |
html | ✓ | HTML 全文 |
changelog | この版の変更内容 |
list_artifacts
project 内の artifact を一覧します。
| 引数 | 必須 | 説明 |
|---|---|---|
workspace_slug | ✓ | workspace の slug |
project_slug | ✓ | project の slug |
folder_path | folder で絞り込み |
get_artifact_comments
artifact のレビューコメントを取得します。
| 引数 | 必須 | 説明 |
|---|---|---|
artifact_id | ✓ | 対象 artifact の ID |
version_number | 特定の version に絞り込み | |
status | open（デフォルト）または resolved |
get_revision_prompt
未解決コメントから、AI に渡せる修正指示（revision prompt）を組み立てて返します。
| 引数 | 必須 | 説明 |
|---|---|---|
artifact_id | ✓ | 対象 artifact の ID |
version_number | 特定の version を基準にする |
トラブルシューティング
- 認証画面が開かない / 401 が続く — Claude Code で
/mcpから再認証してください。直らない場合はclaude mcp remove traypageしてから追加し直します。 Workspace not found— slug が正しいか、OAuth 認可時にその workspace へのアクセスを許可したかを確認してください。list_artifactsの前に workspace の slug をアプリの URL（/app/{workspace-slug}）で確認できます。Project not found— project は自動作成されません。先にアプリで project を作成してください。- 投稿はできるがコメントが取れない — API トークンのスコープに
comment:readが含まれているか確認してください。