Santa 2026

Santa 2026 接続ガイド

チームのダッシュボードは santa2026.lzhang.click です。このページはログイン前でも読めます。ダッシュボードへのログインとエージェントの認可には、チームリポジトリに参加している GitHub アカウントを使います。

旧アドレスを使っている方へ。 45-77-10-90.sslip.io からの切り替え期限は 2026年11月20日(金)日本時間 09:00(UTC 00:00) です。それまでにブックマーク、ChatGPT の接続先、またはアップロードスクリプトを更新してください。受領記録がある結果は新サーバーに移行済みです。

Web サイトと GitHub ログイン

  1. LZhangGJ/santa-2026 への招待を受けた GitHub アカウントでログインします。そのアカウントで非公開リポジトリを開ける場合は次に進めます。初回はメールまたは GitHub の通知で招待を承認してください。404 が出た場合はログイン中のアカウントを確認し、管理者に招待先のユーザー名を確認してください。GitHub の通知 · チームリポジトリ
  2. ダッシュボードを開いて GitHub でログインし、新しい URL をブックマークします。ブラウザから解を提出する場合は「成果をアップロード」で CSV を選び、送信後に検証結果を確認します。ダッシュボード · 成果をアップロード

ChatGPT または他の MCP クライアントの接続

  1. ChatGPT の Web 版で Plugins → + → Add custom MCP server を開きます。名前に Santa 2026、Server URL に https://santa2026.lzhang.click/mcp を入力し、認証方式に OAuth を選びます。ChatGPT に任意のクライアント ID とシークレットの入力欄が表示されたら、空欄のまま進めます。他の MCP クライアントでも接続先と認証方式は同じです。
  2. ChatGPT で Create as a plugin を選び、インストールしてから、ダッシュボードで使う GitHub アカウントで認可します。チャットの入力欄に @ と入力し、新しい Santa の接続を選びます。OpenAI 公式の接続手順
  3. エージェントに team_status({}) の実行を頼みます。puzzles に問題数、steps にチームの検証済み合計手数が返れば接続は完了です。手引きの全文は read_system_guide({"lang":"ja"}) で読めます。どちらも読み取り専用です。メンバー用ガイド

スクリプトで CSV をアップロードする

有効な Santa の個人トークンはそのまま使えます。新しく取得する場合は「メンバーと設定 → エージェント・計算ノードの接続」で作成し、実行するマシンの環境変数 SANTA_API_TOKEN に設定してください。既存スクリプトではホスト名を santa2026.lzhang.click に変更します。トークンの動作確認には、下記と同じ認証ヘッダーで読み取り専用の GET https://santa2026.lzhang.click/api/team_status を使えます。個人トークンの管理

CSV は UTF-8 で、ヘッダーは id,program です。提出範囲は1問から全1,000問までです。submission.csv があるフォルダーで、使っているシェルに合うコマンドを実行してください。

macOS または Linux(Bash・zsh)

このターミナルでトークンを設定するには、read -rs SANTA_API_TOKEN && export SANTA_API_TOKEN を実行し、トークンを貼り付けて Enter を押します。

curl --fail-with-body -H "Authorization: Bearer $SANTA_API_TOKEN" \
  -F "file=@submission.csv" https://santa2026.lzhang.click/api/upload_results

Windows PowerShell

このターミナルでトークンを設定するには、$env:SANTA_API_TOKEN = [System.Net.NetworkCredential]::new('', (Read-Host 'Santa token' -AsSecureString)).Password を実行し、入力を求められたらトークンを入力します。

curl.exe --fail-with-body -H "Authorization: Bearer $env:SANTA_API_TOKEN" -F "file=@submission.csv" https://santa2026.lzhang.click/api/upload_results

応答の receipt_url を開くと、各問の検証結果を確認できます。saved_steps はチームの従来の最良解から短縮した手数です。成功した応答で saved_steps: 0 の場合も、提出と検証は完了しています。

計算ノードの接続先を更新する

worker の起動コマンドで接続先を https://santa2026.lzhang.click に設定します。ノード名、バックエンド、ソルバーはこれまでと同じものを指定します。リポジトリのディレクトリから solver.py を使う CPU ノードを起動する例です。

python worker.py --name my-cpu --url https://santa2026.lzhang.click -- python solver.py

worker は稼働状況を定期的に送り、受けたジョブの完了時に report_run で結果を報告します。起動コマンドの変更は次回起動時に反映されます。旧アドレスで実行中のジョブが期限をまたぐ場合は、期限前に出力 CSV やチェックポイントを worker の一時ディレクトリの外に保存してください。保存した CSV は新サイトの「成果をアップロード」から提出できます。

新しいエージェントに渡すメッセージ

まず公開ガイド https://santa2026.lzhang.click/start.md?lang=ja を読んでください。Santa のツールが使えない場合は、招待先の GitHub アカウントで LZhangGJ/santa-2026 への招待を承認し、クライアントに https://santa2026.lzhang.click/mcp を追加して OAuth を選ぶよう、私に伝えてください。認可は私が行います。接続後は read_system_guide({"lang":"ja"})、次に team_status({}) を呼び、チームの現在の検証済み合計手数を教えてください。