# Santa 2026 接続ガイド

チームのダッシュボードは [santa2026.lzhang.click](https://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 の通知](https://github.com/notifications) · [チームリポジトリ](https://github.com/LZhangGJ/santa-2026)
2. ダッシュボードを開いて GitHub でログインし、新しい URL をブックマークします。ブラウザから解を提出する場合は「成果をアップロード」で CSV を選び、送信後に検証結果を確認します。[ダッシュボード](https://santa2026.lzhang.click/) · [成果をアップロード](https://santa2026.lzhang.click/progress)

## 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 公式の接続手順](https://developers.openai.com/api/docs/guides/custom-mcp-server)
3. エージェントに `team_status({})` の実行を頼みます。`puzzles` に問題数、`steps` にチームの検証済み合計手数が返れば接続は完了です。手引きの全文は `read_system_guide({"lang":"ja"})` で読めます。どちらも読み取り専用です。[メンバー用ガイド](https://santa2026.lzhang.click/documents/system-guide)

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

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

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

**macOS または Linux（Bash・zsh）**

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

```sh
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` を実行し、入力を求められたらトークンを入力します。

```powershell
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 ノードを起動する例です。

```sh
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({})` を呼び、チームの現在の検証済み合計手数を教えてください。
