リファレンス自動化リファレンス

AI ツールの接続とスキルのインストール

Claude Code・Codex・Cursor などの AI ツールに Nadoo Bio MCP サーバーを接続し、エージェントスキルをインストールします。

Nadoo Bio MCP サーバーのアドレスは https://nadoo.bio/mcp で、streamable HTTP を使います。API キーは Authorization: Bearer ヘッダーで送信します。MCP 接続用 OAuth は未対応なので、ヘッダーを設定できるクライアントを使ってください。ブラウザーのログインと MCP の API キー認証は別です。

  1. API キーを準備
  2. AI ツールを接続
  3. 接続を確認
  4. スキルを導入

1. API キーを準備する

  1. 左メニューの API キーで名前・スコープ・有効期間(30・90・365日、標準90日)を選んで発行します。キーが表示されるのは発行直後の一度だけなので、その場でコピーしてください。
  2. キーを環境変数 NADOO_BIO_API_KEY に設定します。次の入力方法ではキーが画面やシェル履歴に残りません。新しいターミナルでも使う場合はシェル設定またはシークレット管理ツールに設定します。以降のコマンドはこの変数を読み取るため、キーをコマンドラインに直接貼り付けません。
read -rs NADOO_BIO_API_KEY && export NADOO_BIO_API_KEY   # キーを貼り付けて Enter

list_tools・get_tool_schema・search_docs・read_doc はキーなしで呼び出せます。それ以外のツールにはキーと以下のスコープが必要です。AI ツールで計画を作成・送信するには計画作成とジョブ送信の両方の権限を付けます。AI が作成した計画も、人が Web で承認する必要があります。

スコープ画面上の名前このスコープが必要な MCP ツール
catalog:readツール一覧の読み取りvalidate_input
jobs:readジョブ・結果の読み取りget_candidate_selection, preview_candidate_selection, list_candidate_inputs, inspect_input, list_projects, list_artifacts, list_jobs, get_job, get_result, query_result_table, read_result_file, preview_structure_comparison, create_structure_comparison, list_structure_comparisons, get_structure_comparison, list_result_views, render_result_view, get_job_events, list_workflow_runs, get_workflow_run, get_plan, list_plans, get_provenance, create_view_link
plans:write実行計画の作成list_execution_options, prepare_design_input, create_plan, label_plan, rerun_plan, create_batch_plans, preview_batch_plans
jobs:submitジョブの送信submit_plan, submit_delegated_plan, submit_batch, cancel_job
files:writeファイルのアップロードcreate_upload, get_upload, complete_upload, cancel_upload, create_structure_comparison

2. 接続方法を選ぶ

以下からお使いの AI ツールの接続方法を選んでください。MCP サーバーを接続した後、5 節のスキルをインストールすると、Nadoo Bio の作業手順も利用できます。

3. クライアントごとの手動設定

Claude Code

claude mcp add --transport http nadoo-bio -s user https://nadoo.bio/mcp --header 'Authorization: Bearer ${NADOO_BIO_API_KEY}'

-s user を付けると全プロジェクトで使えるユーザー範囲に登録します。省略すると現在のプロジェクトだけの local 範囲になります。単一引用符の中の ${NADOO_BIO_API_KEY} はシェルが展開せず文字どおり保存され、Claude Code が接続時に環境変数の値に置き換えます。そのため設定ファイルにキーの値は残らず、Claude Code を起動する環境に NADOO_BIO_API_KEY が必要です。二重引用符で囲むとシェルがキーの値を展開してそのまま保存されるため、使わないでください。

Codex

codex mcp add nadoo-bio --url https://nadoo.bio/mcp --bearer-token-env-var NADOO_BIO_API_KEY

Codex は環境変数名だけを保存し、起動時に値を読み取ります。Codex を起動するシェルまたはアプリの環境に NADOO_BIO_API_KEY が必要です。

JSON 設定ファイルを使うクライアント

ツール設定ファイルアドレスのキー
Cursor.cursor/mcp.json(プロジェクト)または ~/.cursor/mcp.jsonurl
Windsurf~/.codeium/windsurf/mcp_config.jsonserverUrl
Gemini CLI~/.gemini/settings.jsonhttpUrl
Clinecline_mcp_settings.json(Cline の MCP 設定画面から開きます)url に加えて "disabled": false を設定

以下は Cursor の例です。他のクライアントでは、表に合わせてアドレスのキー名を変更します。

{
  "mcpServers": {
    "nadoo-bio": {
      "url": "https://nadoo.bio/mcp",
      "headers": {
        "Authorization": "Bearer <API_KEY>"
      }
    }
  }
}

この例では API キーを設定ファイルに直接保存するため、リポジトリにコミットしないでください。環境変数やシークレット入力を使う場合は、AI ツールが対応する設定方法に従ってください。

VS Code

コマンドパレットで MCP: Add Server、次に HTTP を選び、アドレス https://nadoo.bio/mcp と名前 nadoo-bio を入力します。作成された設定に Authorization ヘッダーを追加します。ヘッダーとシークレット入力の方法は VS Code の文書を参照してください。

アドレスだけを受け付けるコネクター

API キーが必要な MCP ツールを使うには、認証ヘッダーを設定できる接続方法が必要です。サーバー URL しか入力できないコネクターでは、ヘッダー設定に対応した別の接続方法を使用してください。Nadoo Bio は MCP 接続用の OAuth 認証を提供しておらず、Web ログインで API キー認証を代替することはできません。

4. 接続を確認する

まず get_connection_context で API キーのアカウント・組織・スコープを確認してください。公開一覧の取得成功は認証成功を意味しません。legacyUnscoped が true の場合は、最小スコープではなく従来のロール権限が使われます。この確認でプロジェクトへのアクセスや有料実行が承認されるわけではありません。Web リンクではブラウザーのログインアカウントを別途確認します。キーを URL に含めないでください。

  • Claude Code は claude mcp list、または会話内で /mcp。Codex は codex mcp list を使います。
  • AI ツールに **「Nadoo Bio のツール一覧を見せて」**と依頼します。list_tools はキーなしでも動くので、失敗した場合は認証より先に接続設定を確認します。

Web で承認した有料ジョブを引き継ぐ

稼働中の環境が対応する USD LIVE 計画では、承認画面のエージェント委任の準備で対象キーを選び、確認と同意を記録します。委任詳細の送信要求を作成 → 送信要求をコピーで取得した JSON をエージェントに渡し、送信を依頼してください。リンクを開いたりコピーしたりするだけでは実行されません。ボタンは現在の承認セッション・期限・実行対応状況に応じて表示され、再ログインだけでは元の承認権限は復元されません。

エージェントはコピーした submit_delegated_plan の arguments をそのまま使い、元の requestKey と本文を保持します。応答消失時は同じコマンドで復旧します。指定の API キーと jobs:submit が必要で、受付後の get_job の照会には別途 jobs:read が必要です。照会権限がない場合は受付失敗と判断したり再送信したりせず、返されたジョブリンクを開きます。API キーは接続設定だけに置き、コマンドや URL に含めません。すべてのモデル・通貨の経路が委任に対応するわけではありません。

5. エージェントスキルをインストールする

スキルは、AI ツールが Nadoo Bio MCP ツールを正しい順序で使うための SKILL.md の指示です。スキル自体が機能を提供するわけではないので、先に MCP を接続します。

スキル使う場面sha256 の先頭12文字
nadoobio-account-and-approval権限・承認・使用上限で作業が止まったときに使います。scope_required・not_found・plan_not_approved・monthly_limit_exceeded・context_changed などの意味と、ユーザーに依頼する内容を説明します。制限の回避や、推測したリソースへのアクセスを防ぎます。a6dd78911a1e
nadoobio-batch-screening複数候補の計画を作り、送信可能な状態か確認するときに使います。単件の呼び出しを繰り返さず、保管した CSV・FASTA で create_batch_plans を実行します。承認・送信可否は approval.status と reason に従います。8689bbba1619
nadoobio-complex-analysis複合体や標的タンパク質分解研究の構造結果で、鎖の対応と接触・配置の指標を確認します。6f6312f2a21c
nadoobio-docking-screening分子ドッキングと候補スクリーニングで、入力準備の条件とスコアの比較可否を確認します。000ad86c87dd
nadoobio-dynamics分子動力学シミュレーションの軌跡・時間・周期境界と結果の解釈を確認します。6a981f354bbc
nadoobio-foldingタンパク質配列から構造を予測する場合や折りたたみ結果を確認する場合に、入力条件と構造信頼度の意味を確認します。b4c914327bd5
nadoobio-input-preparationNadoo Bio でタンパク質研究ツールを選び、入力を準備・検証するときに使います。list_tools でツールを探し、get_tool_schema で入力仕様を読み、validate_input と inspect_input で配列・保存ファイルを確認します。設計領域の準備仕様も確認します。実行計画を作る前の段階です。a6af4a9d52f7
nadoobio-metric-interpretation構造信頼度・比較誤差・候補スコア・実験値を区別し、研究結果の根拠の水準を説明します。366163d78bd8
nadoobio-plan-and-submitlist_execution_options → create_plan → 人の承認 → submit_plan → get_job による定期照会の順でジョブを実行するときに使います。承認リンク・同一要求での再試行・月間上限への対応を扱い、人の承認なしの実行や新しいキーでの重複要求を防ぎます。c84e012f5fdd
nadoobio-protein-design抗体・タンパク質の配列や構造設計の入力条件を定め、設計と検証を区別します。186004f4de2f
nadoobio-reproducibility過去の結果の再現・引用、同じ入力での再実行に使います。get_plan の planHash・リリース・ポリシー、get_provenance の来歴、rerun_plan の元計画とのつながりを説明します。入力を固定しても出力が同一になるとは限りません。4445c2b467eb
nadoobio-research-routing研究の目的から構造予測・ドッキング・設計・複合体・軌跡・指標解釈の必要な作業を選び、現在実行できるツールを探します。fe09e436a89d
nadoobio-result-interpretation結果を読んで次の作業を選ぶときに使います。get_result で検証済みの出力を確認し、read_result_file で指標 CSV などの小さなテキスト結果を読みます。計算予測・構造の信頼度・実際の結合・実験検証を区別して指標を説明します。構造ファイルの比較や保存済み比較の再表示にも使い、数値・画像・結果画面のリンクをユーザーに示します。e8318245b12f
nadoobio-structure-comparison二つのタンパク質構造を比較するときに使います。検証済み結果や保管ファイルからモデル・鎖・領域を確認し、構造の重ね合わせ・Cα RMSD・位置ごとの差を計算して保存し、再度開きます。d911434bfe0f

オープンソースの skills CLI なら、Nadoo Bio のドキュメントドメインから直接インストールできます。Claude Code・Codex・Cursor・Copilot・Windsurf・Cline・Gemini CLI などのスキルフォルダーを自動で探します。更新には npx skills update を使います。

npx skills add https://nadoo.bio          # クライアントとスキルを選択
npx skills add https://nadoo.bio --all -g   # 全スキルをユーザー範囲にインストール

ドメインの /.well-known/agent-skills/index.json にスキル一覧と sha256 があり、skills CLI はその値でファイルを確認します。

MCP サーバーも Skills 拡張(io.modelcontextprotocol/skills)と resources/list を通じて同じスキルを提供します。AI ツールが MCP のスキルリソースを読み取れない場合は、上記のファイルインストール方法を使用してください。

スキルは MIT ライセンスで提供され、コピー・変更・再配布できます。Nadoo Bio のサービス利用にはサービス利用規約が適用されます。

6. キーの更新と接続の削除

キーの有効期限が切れる前に新しいキーを発行し、NADOO_BIO_API_KEY を更新します。Codex と3節の方法で登録した Claude Code は変数を更新するだけで済みます。JSON 設定ファイルにはキーの値が保存されているため、ファイルを修正します。以前の案内どおり二重引用符で登録した Claude Code は設定ファイルにキーの値が残っているため、一度削除して3節のコマンドで登録し直してください。更新が終わったら、API キー画面で古いキーを無効化してください。

claude mcp remove nadoo-bio -s user
codex mcp remove nadoo-bio

トラブルシューティング

症状確認すること
invalid_credentials または authentication_required入力間違い・期限切れ・失効を確認します。メンバーが停止・除外されると、その人のキーも無効になります。
scope_requiredエラーの required が不足しているスコープです。そのスコープを付けて新しいキーを発行してください。
agent_execution_disabledサービス設定で AI エージェントの実行が無効になっているため、照会のみ可能です。管理者に問い合わせてください。
別のサーバーに接続したいAI ツールの設定で、接続先サーバーの /mcp の URL に変更します。

このページの内容