Archivist AI

Archivist AI MCP サーバー

Archivist AIの公式Model Context Protocol（MCP）サーバーです。ゲームマスターやプレイヤー向けの、TTRPGキャンペーン記憶プラットフォームです。

レジストリのメタデータはserver.jsonにあります。公式MCPレジストリへの公開は、バージョンタグに基づいて.github/workflows/publish-mcp.ymlにより自動化されています（git tag v3.0.1 && git push origin v3.0.1）。

Claude、ChatGPT、Cursor、Notion、WindsurfなどのAIアシスタントをキャンペーンデータに直接接続できます。キャラクター、セッション、場所、派閥、アイテム、クエスト、ジャーナル、重要な場面、英雄賞、名言、スポットライトなど、さまざまなデータを利用できます。

クイックスタート

MCP サーバー URL： https://mcp.myarchivist.ai/mcp

Discord ツールは兄弟ホストの https://discord.myarchivist.ai/mcp で利用できます。これは別個の MCP リソース（OAuth と録音ボットが必要）であり、ここにあるキャンペーンツールに代わるものではありません。

{
  "mcpServers": {
    "archivist-ai": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.myarchivist.ai/mcp",
        "--header",
        "X-API-Key:${ARCHIVIST_API_KEY}"
      ],
      "env": {
        "ARCHIVIST_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "archivist-ai": {
      "type": "remote",
      "url": "https://mcp.myarchivist.ai/mcp"
    }
  }
}

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "archivist-ai": {
      "type": "remote",
      "url": "https://mcp.myarchivist.ai/mcp",
      "oauth": false,
      "headers": {
        "X-API-Key": "{env:ARCHIVIST_API_KEY}"
      }
    }
  }
}

{
  "mcpServers": {
    "archivist-ai": {
      "url": "https://mcp.myarchivist.ai/mcp"
    }
  }
}

{
  "mcpServers": {
    "archivist-ai": {
      "serverUrl": "https://mcp.myarchivist.ai/mcp"
    }
  }
}

プロンプトの例

• 「自分のキャンペーンを一覧表示してから、Curse of Strahd キャンペーンの最新セッションを要約してください。」
• 「Silver Hand 陣営で活動する密輸業者、Captain Mirelle Voss という名前の新しい NPC を作成し、Port of Dusk の場所に関連付けてください。」
• 「キャンペーンに『Recover the Moonstone』というクエストを追加し、未完了のクエストと関係するキャラクターをすべて一覧表示してください。」

利用可能なツール

読み取りツールは非破壊的で、冪等です。書き込みツールは標準的な REST のセマンティクスに従います。削除は破壊的かつ冪等で、PATCH は非冪等、PUT は冪等です。テキストを含む説明（Character、Faction、Location、Item、Moment、Beat、Session、Journal）を返すすべての読み取りツールは、任意の with_links パラメーターを受け付けます。編集前にほぼ必ず with_links: true を指定する理由については、以下のウィキリンクを参照してください。

キャンペーンの削除、セッションの削除、商品表示専用のエンドポイント（ビートの並べ替え／一括編集、キャンペーン設定、キャスト／メンバー管理）、マルチパートの録音アップロード、AI 画像生成は意図的に公開していません。

OAuth スコープと書き込みアクセス

https://app.myarchivist.ai 経由で接続する OAuth クライアントは、認証時にスコープを要求します。すべての書き込みツール（作成／更新／削除＋画像アップロード）には、呼び出し元のトークンに agent_write スコープも必要です。

MCP は tools/list で API の適用ルールを反映します。agent_write を持たないエージェントクライアントには読み取りツールのみが表示され、書き込みツールを呼び出そうとすると「tool not found」の JSON-RPC エラーが返されます。API キーの認証情報とエージェント以外の OAuth クライアントにはこのフィルターは適用されません。これらに対する最終的な制御は API が担い、すべてのツールが引き続き表示されます。

agent_write が告知される前に接続した既存の OAuth クライアントは、新しいスコープを含むトークンを取得するため、再認証が必要です。

キャンペーン

セッション

ストーリー構成

ハイライト

ワールド構築

クエスト

ジャーナル

関連付け

画像

ウィキリンク

Archivist AI の説明、要約、モーメントの内容、ジャーナル本文には、実際のレコードを参照する [[Target Name|Optional Alias]] 形式のマークアップを含めることができます。ウィキリンクを含むテキストフィールドを扱う書き込みツールはすべて、既存のリンクを壊さないための簡単な手順に従う必要があります。

必ず守るべきルール

書き込む前に、必ず with_links: true を指定して読み取ってください。 Character、Faction、Location、Item、Moment、Beat、Session、Journal の各 Get／List ツールで、このパラメーターを使用できます。API は既定でウィキリンクを除去して返すため、読み取り、変更、書き込みを行うと、元のレコードにある [[…]] がすべて消えてしまいます。with_links: true を指定すると、括弧を保持したままテキストが返されるので、書き込む際にリンクを維持できます。

レコードごとの仕様

名前の変更と参照先の変更

• エイリアスの変更：括弧の内側を編集します。[[Alice|Al]] → [[Alice|Ali]]。
• 別の対象への参照先の変更：表示される対象名を変更します。[[Alice]] → [[Alicia]]。
• リンクの削除：テキスト内でエイリアスの括弧を外す（自動解決の場合）か、delete_link を呼び出します（明示的なリンクの場合）。
• コンペンディウム対象のキャンペーン全体にわたる名前または参照先の変更：operation: "update" と new_alias、および／または new_target_id を指定して bulk_link_maintenance を使用します。API はバックグラウンドの Webhook で参照先のすべてのテキストフィールドを書き換え、task_id を返します。

画像

エンティティ画像は、直接アップロードによって Character、Faction、Location、Item、Moment、Session、および Campaign 自体に追加できます。MCP サーバーには AI 画像生成ツールはありません。画像生成は Archivist AI アプリの製品機能であり、API の REST エンドポイントからも利用できます。

直接アップロード（2ステップ）

ユーザーがディスク上またはメモリ内にすでに持っている画像には、署名付き URL のフローを使用します。

1. campaign_id、entity_type、entity_id、file_name、content_type（image/* である必要があります）を指定して init_image_upload を呼び出します。object_key、upload_url、public_url、expires_in_seconds が返されます。
2. クライアント（または人間の協力者）が、URL の有効期限が切れる前に、画像の生バイトデータと同じ Content-Type ヘッダーを付けて upload_url に HTTP PUT を実行します。この手順は MCP トランスポートの外部で行われます。
3. object_key、entity_type、entity_id、attach（デフォルトは true）を指定して complete_image_upload を呼び出します。API はアップロードを検証し、NSFW モデレーションを実行します。また、attach が true の場合は、対象エンティティの image フィールドにモデレーション済みの public_url を設定します。

任意の HTTP PUT を実行できないエージェントは、ステップ 1 とステップ 3 の間に、PUT の手順を人間に依頼してください。

削除

delete_entity_image は、次のいずれかの方法でキャンペーン内の画像を削除します。

• エンティティで指定：entity_type と entity_id を渡します。API はレコードから画像を切り離し、元のオブジェクトも削除します。
• URL で指定：管理対象の image_url（例：以前の init_image_upload の応答に含まれるもの）を渡します。オブジェクトのみを削除します。

トラブルシューティング

• 認証に失敗する、またはツールが 401 を返す場合： サーバーを再接続して OAuth サインインをやり直すか、app.myarchivist.ai で API キーが有効か確認してください。
• 書き込みツールが表示されない場合（エージェント OAuth クライアントのみ）： agent_write スコープのないエージェント OAuth クライアントでは、書き込みツールは非表示になります。再接続して書き込みアクセスを承認してください。API キーとエージェント以外の OAuth クライアントでは、常にすべてのツールが表示されます。詳しくはOAuth スコープと書き込みアクセスを参照してください。
• Claude Desktop が接続しない場合： mcp-remote プロキシと Node.js が必要です。設定を編集した後、Claude Desktop を再起動してください。
• 編集後にウィキリンクが消える場合： 更新前に with_links: true を指定してレコードを読み込んでください。ウィキリンクを参照してください。

プライバシーとサポート

• プライバシーポリシー： https://www.myarchivist.ai/privacy
• サポートおよびセキュリティに関するお問い合わせ先： [email protected]
• コミュニティ： Discord