Research CI スタートガイド

• あなたの user_id
• GitHub 接続用と Notion 接続用の招待リンク（有効期限 7 日。期限切れなら再発行を依頼）
• Zotero 用サービス zotero-user-<user_id> がある Railway project への招待
• （手順 5 の後）Research CI トークン rci_... と MCP の URL

GitHub に seed 用の private repository を用意し、ルートに seed.md を置きます。 これは論文の草稿ではなく、あなたの現在の研究状態です。問い生成は「手持ちの結果の中の異常」から出発するので、 結果・計算・失敗例のセクションが最も効きます。

---
seed_id: my-research-seed
title: A one-line statement of what this seed is about
domain: quantum
visibility: private
owner: your-github-handle
---

## Problem
## Current claim / hypothesis
## Known results
## Assumptions
## Open questions
## Existing calculations
## Relevant literature
## Failure cases / counterexamples

• TODO / TBD / HTML コメントだけのセクションは空とみなされます。
• Existing calculations には repository 内のパスを書いてください。CI はそのファイルを実際に読みます。存在しないパスは報告され、その計算は確立済みとして扱われません。
• 見出しのタイプミスは警告として報告されます（黙って捨てられることはありません）。

Core が手元にある場合は push 前に検証できます:

research-ci seed validate ./seed.md   # READY=0 / INCOMPLETE=1 / REJECTED=2

1. GitHub 用の招待リンクを開き、Research CI GitHub App をインストールします。
2. アクセスを許可する repository に、seed repository と、結果を書き戻す CI 書き込み先（同じ repo でも可）を含めます。
3. 完了したら、どの repo を seed / 書き込み先にするかを運営者に伝えてください 運営者が bind。

Personal Access Token は預かりません。Gateway は App から1時間で失効するトークンをその都度発行します。 結果は常に research-ci/<seed>-<run> ブランチの Pull Request として届き、main へ直接 push されることはありません。

1. Notion 用の招待リンクを開き、ワークスペースへのアクセスを許可します。
2. Research CI に読ませたいページを共有します（許可画面で選択、または各ページの ••• → 接続（Connections） → Research CI）。 最低1ページの共有が必要です。
3. 問いの記録先 Research Questions データベースは自動で探索・作成されます。

開発版では、Zotero の資格情報をご本人が自分専用のサービス zotero-user-<user_id> に登録します。 key は Gateway にも運営者にも渡りません。

4-1. Zotero で key を発行する

1. zotero.org/settings/keys を開きます（ログインが必要）。
2. ページ上部の 「Your user ID for use in API calls is ○○○○」 の数字を控えます。これが ZOTERO_LIBRARY_ID です（ユーザー名ではありません）。
3. Create new private key を押し、次のように設定します。
   • Key Name: 例 research-ci
   • Personal Library: Allow library access に✔（Allow notes access は任意）
   • Allow write access はオフのまま（Research CI は読み取りのみ）
   • グループライブラリを使う場合のみ、該当グループに Read Only を付与
4. Save Key を押すと key が一度だけ表示されます。次の手順ですぐ使います。

4-2. Railway のサービスに登録する

1. 招待された Railway project を開き、サービス zotero-user-<あなたの user_id> を選びます。他の人のサービスは開かないでください。
2. Variables タブで次の3つを設定します。

3. 変更を反映（Deploy / Apply changes）します。
4. Deployments → View logs に Zotero credential check: OK と出れば成功です。
5. 運営者に「登録した」とだけ伝えてください 運営者がサービスを bind。key の値は伝えないでください。

5項目すべてが ok のときだけ STATUS = READY になります。接続後は Claude から research_ci_preflight でも確認できます。

1. 運営者から Research CI トークン（rci_ で始まる）を受け取ります。表示は一度きりなので、パスワードマネージャーに保存してください。有効期限は既定で 90 日です。
2. Claude の 設定 → コネクタ → カスタムコネクタを追加 で、運営者から案内された MCP の URL（https://…/mcp の形）を登録します。
3. 接続すると Connect Research CI という画面が開くので、rci_... トークンを貼って Connect を押します。
4. ツール一覧に research_ci_preflight などが表示されれば完了です。

このトークンはあなた自身の user_id にしか届きません。他の人の研究状態は読めませんし、他の人からあなたの状態も読めません。