AI 連携ガイド

接続する

シュピログのアカウントが必要です。連携中のアプリと利用状況はメニュー → AI 連携で確認・失効できます。

できること

接続した AI は、次のカテゴリの tool を使ってシュピログを操作できます。

• プレイログプレイの記録（クイック記録・セッション単位の記録）、参加者・スコアの管理、プレイ統計の取得。
• コレクション持っているゲームの追加・削除、所有ステータス・メモ・タグの編集。
• ゲームデータベースゲームの検索・詳細取得。新しいゲームや人物・シリーズの登録提案、既存データの修正提案（アシスタント経由の提案は、いずれもメンテナの確認後に反映）。
• コンテンツゲーム紹介動画の投稿・一覧取得。

接続用 URL

• トランスポートは Streamable HTTP（HTTPS）です。stdio / SSE 専用の接続は提供していません。

認証（OAuth 2.1）

認証は OAuth 2.1 の認可コードフロー（PKCE 必須・public client）です。接続時にブラウザでシュピログにログインし、要求された権限に同意すると利用を開始できます。API キーの発行はありません。

• Dynamic Client Registration（RFC 7591）に対応しており、クライアントは自動登録されます。
• サーバーメタデータは次の URL で公開しています:https://spielogue.com/.well-known/oauth-authorization-server/https://spielogue.com/.well-known/oauth-protected-resource
• アクセストークンの権限は、同意した scope の範囲に常に制限されます。

権限（scope）

接続時の同意画面で、AI に許可する操作の範囲を選べます。読み取り・書き込みはすべてあなた自身のデータが対象で、他のユーザーの非公開情報には触れません。

• read読み取り

  あなたのプレイログ・コレクション・提案、ゲームデータベースを読み取ります。他ユーザーの非公開情報には触れません。

• playlog:writeプレイログの作成・編集

  プレイログのセッション・ゲームプレイを作成・更新・削除できるようになります。

• collection:writeコレクションの編集

  ゲームをコレクションに追加・削除し、所有ステータス・メモ・タグを変更できます。

• database:writeゲームデータベースへの提案

  ゲームデータベースに対する新規ゲーム / 既存ゲーム・人物・シリーズの追加・更新提案を作成・取り下げできるようになります。承認はメンテナが行います。

• content:writeゲームに関するコンテンツの投稿

  ゲームに紐付けるユーザー投稿コンテンツ（紹介動画 URL など）を作成できるようになります。今後追加される投稿系コンテンツも同じ権限で扱われます。既存コンテンツの編集・削除は含みません。

利用上限

• アカウントごとに 1 日あたりの tool 呼び出し回数とアップロード容量に上限があります。自分の上限値はメニュー → AI 連携に表示されます。
• 上限に達すると、tool の呼び出しは上限に達したことを伝えるエラーを返します（AI アシスタントにはその理由が表示されます）。接続の確認や tool 一覧の取得はそのまま使えます。上限は日本時間 9 時（UTC 0 時）にリセットされます。

データの取り扱い

• AI 連携で取得・送信されるデータの取り扱いは、プライバシーポリシー（連携アプリ・外部 API に関する条項）と利用規約に従います。
• 接続済みのアプリと発行済みトークンはメニュー → AI 連携でいつでも確認・解除（失効）できます。

うまく動かないとき

エラーが出る・認証が通らない・tool が応答しないなど、これまで動いていた連携が動かなくなった場合は、一度連携を解除して、最初から設定し直してください。次の順に行います。

1. メニュー → AI 連携を開き、「連携中のアプリ」から対象のアプリの連携を失効する。
2. AI（ChatGPT / Claude など）側でも、追加した Spielogue（アプリ・コネクタ）を削除する。（こちらを消さずに追加し直すと、古い接続情報が残ったままになります）
3. あらためて接続するの手順で追加し直し、ログインと権限の同意をやり直す。

設定し直しても解決しない場合は、問い合わせフォームからご連絡ください。