accessoticketing-mcp

accessoticketing-mcp

accesso Passport モバイルチケットリンク向けの MCP サーバーです。購入後に会場からメールで届く URL を読み込みます。注文と注文に含まれるすべての入場券、スキャン可能なバーコード、Google Wallet への保存リンクを取得します。

accesso は多くのテーマパーク、ウォーターパーク、キャンプ場、博物館、フェスティバルのチケット販売を支えているため、このサーバーひとつですべてに対応できます。リンクに販売事業者の情報が埋め込まれているためです。

AI（Claude Code）によって開発・保守されています。ご自身の判断でご利用ください。

必要なもの

ログインは不要です。 リンク自体に認証情報が含まれています。クエリ文字列の oToken が読み取りを許可します。アカウント、パスワード、ブラウザーセッション、ボット対策の壁はありません。

警告

つまり、リンクは秘密情報でもあります。リンクを持っている人は誰でも、注文内のチケットを閲覧したり追加したりできます。パスワードと同様に扱い、課題、ログ、チャットには貼り付けないでください。このサーバーは出力とエラーメッセージからトークンを除去します。

インストール

npx -y @chrischall/accessoticketing-mcp

// claude_desktop_config.json / .mcp.json
{
  "mcpServers": {
    "accessoticketing": {
      "command": "npx",
      "args": ["-y", "@chrischall/accessoticketing-mcp"],
      "env": { "ACCESSO_TICKET_URL": "https://media-engine.na3.accessoticketing.com/tickets/v1/..." }
    }
  }
}

ACCESSO_TICKET_URL は任意です。設定すると、呼び出しのたびに url を渡す手間を省けます。設定しなくてもサーバーは正常に起動し、初回使用時にリンクがないことを通知します。

変数	必須	用途
ACCESSO_TICKET_URL	いいえ	ツールの呼び出し時に url が指定されていない場合に使用するデフォルトのチケットリンクです。
ACCESSO_OUTPUT_DIR	いいえ	accesso_save_barcodes が PNG を書き込む場所です。デフォルトは cwd です。cwd が /（Claude Desktop）の場合は ~/Downloads です。
ACCESSO_NO_FILE_OUTPUT	いいえ	ファイルシステムがユーザーのものではない場合（ホスト型デプロイなど）に 1 を設定すると、バーコードがインラインで返されます。

ツール

ツール	内容
accesso_get_order	注文と注文に含まれるすべての入場券を取得します。商品、参加者、日付、開始時刻、案内が含まれます。デフォルトではチケットごとの簡易リストを返し、view: "full" を指定すると解析済みの全フィールドを返します。
accesso_get_ticket	index で指定した入場券の詳細を取得します。
accesso_save_barcodes	バーコードの PNG を書き込んでパスを返すか、画像をインラインで返します。
accesso_get_wallet_passes	チケットの Google Wallet 保存リンクを取得します。
accesso_resolve_link	メールのクリック追跡リンクを、隠されている accesso URL に展開します。
accesso_healthcheck	接続可能かどうか、およびデフォルトリンクが設定されているかを確認します。

ここにあるツールは注文を変更しません。accesso_save_barcodes を除き、すべて読み取り専用です。accesso_save_barcodes はインライン画像を要求された場合を除き、PNG ファイルをディスクに書き込みます（既存ファイルを上書きすることはありません）。

> what do we have booked tomorrow?
9:00 AM   Tiny Trekkers Full-Day (Ages 4-7)   — one participant
9:00 AM   Whitewater Kayak Camp I: Intro      — two participants
all-day   Lunch / Snack / Early Drop-Off      — nine more admissions

シェルで使うスキル

シェルでの操作をお好みですか？ skills/accesso-tickets/ では、サーバーを使わずに curl と依存関係のないパーサーで同じ情報を読み取れます。パッケージに同梱されています。

データに関する注意事項

• date／time は販売事業者の現地時刻を表す文字列で、タイムゾーン情報は付いていません。変換せず、そのまま渡されます。
• 販売事業者固有の詳細行（Guest Number、Web Sales ID、…）は汎用的に収集され、details に格納されるため、これまでテストしたことのない会場でも動作します。
• リンクの有効期限が切れている場合も、エラーステータスではなく HTTP 200 が返されます。サーバーはレスポンス本文を検出し、チケットがゼロ件だと報告するのではなく、リンクの有効期限が切れていると通知します。

開発

npm install
npm run build
npm test
npm run test:coverage   # 100% thresholds, enforced in CI

記録されたリクエスト／レスポンスの形式については docs/ACCESSO-API.md を、リポジトリの規約については CLAUDE.md を参照してください。

ライセンス

MIT