Tavern について
Tavernは、テーブルトップRPGのグループ向けに、キャンペーン記録とプレイ管理の共有スペースを提供するホスト型MCPサーバーです。AIクライアントからセッション記録、Wikiページ、マップ、キャラクターシート、非公開メモ、戦闘管理にアクセスでき、参加者の役割に応じて権限が制御されます。
主な機能
- 01日付付きセッションと共有メモの管理
- 02相互リンクされたキャンペーンWikiの管理
- 03共有・非公開マップピンの追加
- 04キャラクター状態と呪文スロットの追跡
- 05戦闘の設定と進行
- 06プレイヤーの非公開メモの保存
活用シーン
- 01グループのメモからセッションを振り返る
- 02新しいNPCページをセッション記録にリンク
- 03プレイ中にキャラクターのHPを更新
- 04戦闘のターンと参加者を管理
MCP 対応
ホスト型サーバーは `https://gettavern.app/mcp` にあり、Streamable HTTPでMCPクライアントにキャンペーンとゲーム管理ツールを提供します。OAuth 2.1とPKCE、または個人APIキーで認証し、利用可能なツールは許可されたスコープで決まります。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://gettavern.app/mcpclaude mcp add --transport http jakehandy-tavern https://gettavern.app/mcp{"mcpServers":{"jakehandy-tavern":{"type":"http","url":"https://gettavern.app/mcp"}}}Cursor で開く{"servers":{"jakehandy-tavern":{"type":"http","url":"https://gettavern.app/mcp"}}}VS Code で開く{"mcpServers":{"jakehandy-tavern":{"type":"http","url":"https://gettavern.app/mcp"}}}{"mcpServers":{"jakehandy-tavern":{"serverUrl":"https://gettavern.app/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
詳細
Tavern MCP サーバー
テーブルトークRPGキャンペーンをツールとして活用できます。Tavern は、TTRPG グループのキャンペーン情報を一元管理します。全員のメモを含む日付付きセッション、登場する人物・場所・物の Wiki、ピン付きマップ、現在のヒットポイントと呪文スロットが反映されるキャラクターシート、戦闘トラッカー、各プレイヤーのプライベートメモがそろっています。このサーバーを使えば、Claude、Cursor、VS Code、その他の MCP クライアントが、いつも参加しているテーブルであなたになり代わって、それらすべてを操作できます。
このリポジトリに含まれるのは掲載用のファイルのみです。README、レジストリエントリー、Gemini CLI 拡張機能マニフェスト、アイコンが含まれています。サーバーは Tavern がホストしているため、インストールも実行も不要です。
| サーバーアドレス | https://gettavern.app/mcp |
| トランスポート | Streamable HTTP(リモート、ステートレス) |
| サインイン | PKCE を使った OAuth 2.1、または個人用 API キー |
| レジストリ名 | io.github.jakehandy/tavern |
| ドキュメント | gettavern.app/developers |
依頼できること
- 「全員のメモをもとに、木曜日のセッションを要約して。」
- 「Hollowmere の渡し守の Wiki ページを作って、今夜のメモにリンクして。」
- 「Ilsa は 9 ダメージを受けて、伏せ状態です。」
- 「直近 3 回のセッションで、どの伏線が放置されていますか?」
- 「パーティーと 3 人の料金所の橋の盗賊との戦闘を設定して。」
- 「自分のキャラクターには、何が残っていますか?」
無料の Tavern アカウントとキャンペーンが必要です。gettavern.app/signin から登録してください。
接続方法
Claude
Settings の Connectors からカスタムコネクターを追加し、https://gettavern.app/mcp を貼り付けます。Claude が Tavern のページを開き、接続を許可するか確認します。
Claude Code
claude mcp add --transport http tavern https://gettavern.app/mcp
その後、セッション内で /mcp を実行してサインインします。
Cursor
~/.cursor/mcp.json に追加します。Cursor は初回接続時にサインインを求めます。
{
"mcpServers": {
"tavern": {
"url": "https://gettavern.app/mcp"
}
}
}
VS Code
ワークスペースの .vscode/mcp.json またはユーザー設定に追加します。
{
"servers": {
"tavern": {
"type": "http",
"url": "https://gettavern.app/mcp"
}
}
}
Gemini CLI
このリポジトリは Gemini CLI 拡張機能です。インストールした後、Gemini CLI 内で /mcp auth tavern を実行してサインインします。
gemini extensions install https://github.com/jakehandy/tavern-mcp
その他
Streamable HTTP に対応するクライアントなら、自動的にサインイン方法を見つけます。ヘッダーしか指定できないクライアントでは、代わりに個人用 API キーを送信できます(Tavern の Settings、API and assistants で作成してください)。
{
"url": "https://gettavern.app/mcp",
"headers": { "Authorization": "Bearer tvn_your_key" }
}
サインイン
クライアントが初めて接続すると、サーバーはサインイン先を示す 401 を返し、クライアントは Tavern 独自の同意ページを開きます。そこでサインインし、アプリが求めている内容を確認して、要求された範囲より少ない権限を付与することもできます。
- パブリッククライアント向け OAuth 2.1:PKCE(S256)を使用し、クライアントシークレットは不要です。クライアントは、動的クライアント登録(RFC 7591)を行うか、自身の Client ID Metadata Document を使用して登録します。アクセストークンの有効期間は 1 時間です。リフレッシュトークンは使用するたびにローテーションされます。
- スコープは段階的に追加されます:
read、write、deleteの順です。クライアントに表示されるツールは、許可されたスコープに応じて決まります。 - メタデータ:
/.well-known/oauth-protected-resource/mcpおよび/.well-known/oauth-authorization-server。詳しくは gettavern.app/auth.md をご覧ください。 - 取り消し:すべてのキーと接続済みアプリは Settings、API and assistants に表示され、最終使用日時も確認できます。削除すると、すぐに無効になります。
接続済みアプリがアクセスできるのは、あなた自身の権限の範囲内だけです。参加しているテーブルに、それぞれのテーブルでのあなたの役割に応じてアクセスします。そのため、プレイヤーの接続では GM の役割を果たせず、誰のプライベートメモも、その作成者以外には提供されません。
ツール
2026年11月時点で、14グループに117個のツールがあります。サーバーが正しい情報を提供します。クライアントには、サインインで許可されたツールだけが正確に表示されます。また、gettavern.app/developers では、すべての引数を含む最新のカタログをいつでも確認できます。各ツールには、タイトルと読み取り専用または破壊的操作を示すヒントが付いています。
キャンペーンはスラッグ、セッションはプレイ日(YYYY-MM-DD)、Wiki ページとキャラクターはスラッグで指定します。まず list_campaigns を使用してください。
読み込むツールを減らすには、アドレスに ?toolsets= を追加し、グループキー(account、campaigns、sessions、wiki、notes、messages、map、characters、builder、combat、lorekeeper、memorial、dice、updates)またはプリセットの core を指定します。例:https://gettavern.app/mcp?toolsets=core,characters。
あなた
認証情報の本人、公開プロフィール、招待、フィードバックを確認します。
| ツール | 機能 | スコープ |
|---|---|---|
whoami | 自分が誰かを確認する | 読み取り |
list_campaigns | 自分のキャンペーンを一覧表示する | 読み取り |
respond_to_invitation | 招待に回答する | 書き込み |
get_profile_settings | 自分のプロフィール設定を取得する | 読み取り |
update_profile_settings | 自分のプロフィール設定を変更する | 書き込み |
get_subscription | 自分のサブスクリプションを取得する | 読み取り |
get_public_profile | 公開プロフィールを読む | 読み取り |
send_feedback | フィードバックを送信する | 書き込み |
list_my_feedback | 自分のフィードバックを一覧表示する | 読み取り |
キャンペーンと参加枠
テーブルを作成し、参加枠を埋め、見た目を変更し、キャンペーンから退出します。
| ツール | 機能 | スコープ |
|---|---|---|
create_campaign | キャンペーンを作成する | 書き込み |
get_campaign | キャンペーンを取得する | 読み取り |
update_campaign_look | キャンペーンの見た目とレターを変更する(GM のみ) | 書き込み |
list_seats | 参加枠を一覧表示する | 読み取り |
add_seat | 参加枠を追加する(オーナーのみ) | 書き込み |
remove_seat | 参加枠を削除する(オーナーのみ) | 削除 |
get_my_seat | 自分の参加枠を取得する | 読み取り |
update_my_seat | 自分の参加枠を変更する | 書き込み |
leave_campaign | キャンペーンから退出する | 削除 |
セッションジャーナル
プレイ日と、その日にみんなが書いたメモを管理します。
| ツール | 機能 | スコープ |
|---|---|---|
list_sessions | セッションを一覧表示する | 読み取り |
get_session | セッションを読む | 読み取り |
create_session | セッションを記録する(GM のみ) | 書き込み |
update_session | セッションの名前または日付を変更する(GM のみ) | 書き込み |
add_session_note | セッションにメモを追加する | 書き込み |
update_session_note | セッションのメモを編集する | 書き込み |
delete_session_note | セッションのメモを削除する | 削除 |
キャンペーン Wiki
あらゆる人物、場所、物事に関するページとその履歴、そしてそれらすべての検索を行います。
| ツール | 機能 | スコープ |
|---|---|---|
list_wiki_pages | Wiki ページを一覧表示する | 読み取り |
get_wiki_page | Wiki ページを読む | 読み取り |
get_wiki_page_history | ページの履歴を読む | 読み取り |
create_wiki_page | Wiki ページを作成する | 書き込み |
update_wiki_page | Wiki ページを編集する | 書き込み |
delete_wiki_page | Wiki ページを削除する(GM のみ) | 削除 |
link_wiki_page_to_seat | ページを誰かのキャラクターとして設定する | 書き込み |
search_campaign | キャンペーンを検索する | 読み取り |
自分のメモ
自分だけが読めるメモと、テーブルで自分が書いたすべての内容を管理します。
| ツール | 機能 | スコープ |
|---|---|---|
list_my_notes | 自分のプライベートメモを一覧表示する | 読み取り |
create_my_note | プライベートメモを書く | 書き込み |
update_my_note | プライベートメモを編集する | 書き込み |
delete_my_note | プライベートメモを削除する | 削除 |
get_my_note_history | プライベートメモの履歴を読む | 読み取り |
list_everything_i_wrote | ここで自分が書いたすべての内容を確認する | 読み取り |
メッセージ
同じテーブルにいる参加者同士の直接の会話と、全員に向けたGMのスレッドです。
| ツール | 機能 | スコープ |
|---|---|---|
list_conversations | 自分の会話を一覧表示 | read |
start_conversation | 会話を開始 | write |
read_conversation | 会話を読む | read |
send_message | メッセージを送信 | write |
mark_conversation_read | 会話を既読にする | write |
delete_message | メッセージを削除 | delete |
マップ
テーブルのマップと、マップ上の共有ピンやプライベートピンです。
| ツール | 機能 | スコープ |
|---|---|---|
list_maps | マップを一覧表示 | read |
list_pins | マップ上のピンを一覧表示 | read |
list_my_private_pins | 自分のプライベートピンを一覧表示 | read |
create_pin | ピンを追加 | write |
update_pin | ピンを移動または編集 | write |
delete_pin | ピンを削除 | delete |
update_map | マップの名前を変更、または順序を変更(GMのみ) | write |
delete_map | マップを取り下げ(GMのみ) | delete |
キャラクター
キャラクターシート、ヒットポイント、状態、呪文スロット、アイテム、自作コンテンツ、コンパニオンです。
| ツール | 機能 | スコープ |
|---|---|---|
list_characters | キャラクターを一覧表示 | read |
get_character | キャラクターを読む | read |
get_party | パーティーの概要を表示(GMのみ) | read |
update_character_state | ヒットポイント、状態、またはスロットを変更 | write |
set_character_overlay | 消費済みの項目を置き換え | write |
add_character_from_beyond | キャラクターシートのリンクからキャラクターをインポート | write |
sync_character | インポートしたキャラクターを同期 | write |
set_character_on_hud | マスターハッド上でキャラクターを表示または非表示にする(GMのみ) | write |
play_character | キャラクターを自分のメインキャラクターにする(保有者のみ) | write |
mark_character_fallen | キャラクターを倒れた状態にする | write |
revive_character | キャラクターを復活させる | write |
delete_character | キャラクターを削除 | delete |
assign_character | キャラクターを席に割り当てる(GMのみ) | write |
set_character_portrait | キャラクターのポートレートを設定 | write |
add_custom_item | カスタムアイテムを追加 | write |
update_custom_item | カスタムアイテムを編集 | write |
delete_custom_item | カスタムアイテムを削除 | delete |
add_homebrew_box | 自作カードを追加 | write |
update_homebrew_box | 自作カードを編集 | write |
delete_homebrew_box | 自作カードを削除 | delete |
add_companion | コンパニオンを追加 | write |
update_companion | コンパニオンを編集 | write |
set_companion_state | コンパニオンのヒットポイントを変更 | write |
delete_companion | コンパニオンを削除 | delete |
キャラクタービルダー
キャラクターを一から作成するか、シート自体をデザインします。
| ツール | 機能 | スコープ |
|---|---|---|
create_custom_character | ここでキャラクターを作成 | write |
update_custom_sheet | ここで作成したキャラクターを編集 | write |
list_character_drafts | 作成途中のキャラクターを一覧表示 | read |
start_character_draft | キャラクターの下書きを開始 | write |
get_character_draft | キャラクターの下書きを読む | read |
update_character_draft | キャラクターの下書きを保存 | write |
finish_character_draft | キャラクターの下書きを完成 | write |
delete_character_draft | 下書きを破棄 | delete |
list_sheet_frames | テーブルのシートデザインを一覧表示 | read |
save_sheet_frame | シートデザインをテーブルに保存 | write |
delete_sheet_frame | シートデザインをテーブルから削除 | delete |
戦闘トラッカー
戦闘を進行します:参加者リスト、イニシアチブ、ターン、体力、概要を管理します。
| ツール | 内容 | スコープ |
|---|---|---|
get_combat_roster | 戦闘に参加できるメンバーを確認します(GM のみ) | read |
list_battles | 戦闘の一覧を表示します(GM のみ) | read |
create_battle | 戦闘を準備します(GM のみ) | write |
get_battle | 戦闘を読み込みます(GM のみ) | read |
update_battle | 戦闘の名前またはターンを変更します(GM のみ) | write |
add_participant | 戦闘に参加者を追加します(GM のみ) | write |
update_participant | 戦闘の参加者を変更します(GM のみ) | write |
change_participant_health | 戦闘の参加者にダメージを与えるか、回復させます(GM のみ) | write |
remove_participant | 戦闘から参加者を外します(GM のみ) | delete |
start_battle | 戦闘を開始します(GM のみ) | write |
next_turn | 次のターンに進みます(GM のみ) | write |
end_battle | 戦闘を終了します(GM のみ) | write |
delete_battle | 戦闘を削除します(GM のみ) | delete |
ロアキーパー
セッションのメモをロアキーパーに渡し、記録が作成されるのを確認できます。
| ツール | 内容 | スコープ |
|---|---|---|
list_lorekeeper_jobs | ロアキーパーのキューを確認します(GM のみ) | read |
queue_session_for_lorekeeper | セッションのメモをロアキーパーに渡します(GM のみ) | write |
cancel_lorekeeper_job | ロアキーパーからメモを取り戻します(GM のみ) | delete |
追悼ページ
キャンペーンを締めくくり、その追悼ページを読みます。
| ツール | 内容 | スコープ |
|---|---|---|
get_memorial | キャンペーンの追悼ページを読み込みます | read |
complete_campaign | キャンペーンを完了します(GM のみ) | write |
reopen_campaign | キャンペーンを再開します(GM のみ) | write |
set_memorial_public | 追悼ページを共有または非公開にします(GM のみ) | write |
ダイス
サーバー上であらゆるダイスを振り、アプリでのダイスの見た目を選べます。
| ツール | 内容 | スコープ |
|---|---|---|
roll_dice | ダイスを振ります | read |
get_dice_style | 自分のダイススタイルを確認します | read |
set_dice_style | 自分のダイススタイルを変更します | write |
通知と進捗状況
各卓の最新情報と、これまでの進捗状況を確認できます。
| ツール | 内容 | スコープ |
|---|---|---|
list_notifications | 自分の通知の一覧を表示します | read |
count_unread_notifications | 未読通知の数を確認します | read |
mark_notifications_read | 通知を既読にします | write |
delete_notification | 通知を消去します | delete |
get_my_progress | 自分のタバーンレベルと実績を確認します | read |
list_achievements | すべての実績を表示します | read |
REST API としても利用できます
同じカタログを https://gettavern.app/api/v1 の REST API として利用できます。詳細は /openapi.json と、文章による説明 /api-docs.md をご覧ください。
curl https://gettavern.app/api/v1/campaigns -H "Authorization: Bearer tvn_your_key"
リンク
- 開発者向け:gettavern.app/developers
- プライバシーポリシー:gettavern.app/privacy
- 利用規約:gettavern.app/terms
- サポート:[email protected]
ライセンス
このリポジトリ内のファイルは MIT ライセンスで提供されています(LICENSE を参照)。Tavern の名称とマークは対象外です。Tavern サービス自体には、利用規約が適用されます。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。