AIツールとの連携

Grilled Cheese は Model Context Protocol（MCP）に対応しています。MCP は、AI アシスタントが外部サービスを扱うためのオープンな標準です。 Claude、ChatGPT など MCP 対応のツールを接続すると、そのツールはあなたとしてタイムラインを読み、投稿し、フォローし、リアクションし、テーマを編集できるようになります。キーの貼り付けに対応したツールには、自分で発行していつでも失効できるキーを使います。ChatGPT のように MCP の OAuth フローに対応したツールは、コピーの必要がない同意画面を通じて接続します。

接続すると何が起きるのか

MCP クライアントから見ると、Grilled Cheese は名前の付いたツールの集まりです。タイムラインを読む、投稿を作る、誰かをフォローする、テーマを編集する、といった具合です。それらをいつ呼び出すかは AI が決め、何をしてよいかはあなたのキーが決めます。キーは、作成時に指定したアイデンティティ上であなたとして動作し、あなた自身のアカウントにない権限を持つことは決してありません。

読み取りはすべてのアカウントに含まれています。書き込み（投稿、フォロー、リアクション、テーマの編集）は Grilled Cheese Premium の機能です。

キーを作成する

キーは設定 > 開発者にあります。ウェブアプリでは https://grilledcheese.app/settings/developer、アプリでは設定から開けます。

キーの置き場所がわかる名前を付けます（「ノートPCのアシスタント」「自宅サーバー」など）。
キーが代理できるアイデンティティを選びます。複数のアイデンティティを持つキーは、書き込みのたびにどのアイデンティティとして動作するかを指定しなければならないため、ほとんどのキーはひとつだけを指定します。
スコープを選びます。読み取りスコープはすべてのアカウントで使えます。書き込みスコープには有効な Premium サブスクリプションが必要です。
表示されたキーをコピーします。キーが表示されるのは一度だけです。保存されるのはフィンガープリントだけなので、二度と表示できません。失くした場合は新しいキーを発行してください。

ひとつのアカウントが同時に保持できるキーの数には上限があり、Premium でも上限は上がりません。別のキーが必要なときは、既存のキーを失効させて空きを作ってください。また、キーは90日で自動的に失効するため、忘れられたキーが生き続けることはありません。

スコープ

スコープは、そのキーが持つ権限です。キーのスコープ外のツール呼び出しは、誰のキーであっても、毎回拒否されます。

スコープ許可される操作ツール

スコープ	許可される操作	ツール
`posts:read`	タイムライン、投稿、スレッド、検索の読み取り	`get_timeline`、`get_post`、`get_thread`、`search_posts`
`follows:read`	フォロー・フォロワーの読み取り	（API のみ。対応ツールは未提供）
`reactions:read`	自分のリアクションの読み取り	（API のみ。対応ツールは未提供）
`themes:read`	自分のテーマの読み取り	`list_themes`
`identity:read`	自分のプロフィールの読み取り	（API のみ。対応ツールは未提供）
`posts:write`	投稿の作成と、そのキー自身が作った投稿の削除	`create_post`、`delete_post`
`follows:write`	フォローとフォロー解除	`follow`、`unfollow`
`reactions:write`	リアクションと、そのキー自身が付けたリアクションの取り消し	`react`、`unreact`
`themes:write`	自分のテーマの作成と編集	`create_theme`、`update_theme`

posts:read

タイムライン、投稿、スレッド、検索の読み取り

get_timeline、get_post、get_thread、search_posts

follows:read

フォロー・フォロワーの読み取り

（API のみ。対応ツールは未提供）

reactions:read

自分のリアクションの読み取り

（API のみ。対応ツールは未提供）

themes:read

自分のテーマの読み取り

list_themes

identity:read

自分のプロフィールの読み取り

（API のみ。対応ツールは未提供）

posts:write

投稿の作成と、そのキー自身が作った投稿の削除

create_post、delete_post

follows:write

フォローとフォロー解除

follow、unfollow

reactions:write

リアクションと、そのキー自身が付けたリアクションの取り消し

react、unreact

themes:write

自分のテーマの作成と編集

create_theme、update_theme

:write スコープが Premium との境界線です。無料アカウントでも読み取りキーを発行して全体の動きを体験できます。あなたの代わりに投稿・フォロー・リアクション・テーマ編集を行うには、有効なサブスクリプションが必要です。このチェックはキー作成時だけでなく毎回の呼び出しで行われます。サブスクリプションが切れると、キーの書き込みは次のリクエストから使えなくなり、更新すれば再び使えるようになります。

クライアントを接続する

直接接続（Streamable HTTP）

Claude Code や新しめの Claude Desktop を含む最近の MCP クライアントの多くは、ホストされたエンドポイントに直接接続します。

https://api.grilledcheese.app/mcp

キーはベアラートークンとして渡します。 Claude Code なら1行で済みます。

claude mcp add --transport http grilledcheese https://api.grilledcheese.app/mcp --header "Authorization: Bearer <key>"

stdio ブリッジ経由

ローカルプロセスしか起動できないクライアントは、ブリッジパッケージ @grilledcheese/mcp を使います。これはあなたのマシン上で動き、キーをローカルに保持したまま、各リクエストを上記のエンドポイントに中継します。キーが共有の設定サービスに現れることはありません。

Claude Desktop では、claude_desktop_config.json（Settings > Developer > Edit Config）に次を追加します。

{
  "mcpServers": {
    "grilledcheese": {
      "command": "npx",
      "args": ["-y", "@grilledcheese/mcp"],
      "env": { "GRILLEDCHEESE_KEY": "<key>" }
    }
  }
}

Claude Code での stdio 版はこちらです。

claude mcp add grilledcheese --env GRILLEDCHEESE_KEY=<key> -- npx -y @grilledcheese/mcp

そのほかの stdio クライアントでは、npx -y @grilledcheese/mcp --key <key> を起動するように設定してください。複数のアイデンティティを持つキーでは、どのアイデンティティとして動作するかを --identity で指定します。

ChatGPT などの OAuth クライアント

ChatGPT のカスタムコネクタはキーの貼り付けを受け付けません。必要なのは MCP の OAuth フローで、Grilled Cheese はこれに対応しています。キーは使いません。あなた自身としてブラウザでサインインした状態で接続を承認し、何が許可されるのかを事前に確認できます。

ChatGPT を接続するには次のようにします。

ChatGPT でSettings > Connectors を開き、次のサーバー URL でカスタムコネクタを追加します。
```
https://api.grilledcheese.app/mcp
```
ChatGPT が Grilled Cheese の OAuth 対応を検出し、Grilled Cheese のサインインページをブラウザで開きます。サインインしていなければサインインしてください。
同意画面には、コネクタの名前、承認後に戻る先、そしてアイデンティティとスコープの選択肢が、キー作成時とまったく同じ形で表示されます。読み取りスコープはあらかじめ選択されています。書き込みスコープには Grilled Cheese Premium が必要で、これはキーと同じ境界線です。
承認すると、あとは ChatGPT が自動的に接続を完了します。

この方法で作られた接続は、使われている間は自動的に更新され、90日間使われなければ自動的に失効します。毎回の呼び出しにはキーと同じルールが適用されます。接続があなた以上の権限を持つことはなく、書き込みのたびにサブスクリプションが確認され、行われた操作はすべて監査記録に記録されます。

同じコネクタを再承認すると古い接続は置き換えられるため、再接続しても有効な許可が二重に残ることはありません。接続が悪用されていると思われる場合は、ChatGPT でコネクタを削除したうえで [email protected] にご連絡ください。スタッフが接続を即時に失効でき、そのトークンは次の呼び出しから遮断されます。

同意画面は、コネクタがあなた自身のコンピューター上のアドレスへ戻ろうとしている場合にも警告します。 Claude Code のようなデスクトップツールでは正常な動作ですが、それ以外では立ち止まって確認する価値があります。

キーを失効させる

失効も同じ設定 > 開発者画面から行います。各キーにはスコープ、アイデンティティ、作成日、有効期限が表示され、その横に失効ボタンがあります。失効は即座に有効になり、そのキーの次の呼び出しから適用されます。キーを持たせていたツールを使わなくなったとき、あるいは漏えいが疑われるときは、すぐに失効させてください。

安全上の注意

キーがあなた以上の権限を持つことはありません。 あなたがスタッフであってもキーは一般ユーザーの権限に制限され、キーの操作はすべてあなた自身の操作と同じ監査記録に、キーによるものとして記録されます。
プロトコルからそもそも切り離されているものがあります。 チャットとダイレクトメッセージ、インナーサークル、アカウントの復旧、支払い、モデレーションには、どんなスコープのどんなキーからも決して届きません。
破壊的なツールは自らそれを宣言します。 何かを削除するツールにはフラグが付いており、行儀のよいクライアントは呼び出す前にあなたに確認します。
キーはパスワードと同じように扱ってください。 キーを手にした人は、期限切れかあなたが失効させるまで、そのスコープの範囲内で、指定されたアイデンティティとして行動できます。コマンドラインにキーを貼り付けるのではなく上記の環境変数の形を使い、キーをリポジトリにコミットしてはいけません。

開発者設定：キーの作成と失効を行う場所
Grilled Cheese Premium：書き込みスコープを有効にするサブスクリプション

質問や、うまくつながらない接続については [email protected] までご連絡ください。