いつものAIエージェントからNadoo Bioを使う — MCPとスキルの接続方法

いつものAIからNadoo Bioを使う

いつも使っているAIエージェントに「この配列の構造を予測して」と頼み、同じ会話で結果まで確認できたら便利です。Nadoo Bioは、その間に必要な研究ツールと実行環境をつなぎます。エージェントが計画を準備し、人がウェブ画面で内容を確認して承認する流れです。

AIエージェントがMCPとスキルを通じて、Nadoo Bioのツールと入力、計画と承認、ジョブと結果につながる図

新しいチャット画面に移る必要はありません。普段のエージェントにMCPとスキルを接続します。まず何を任せられるのかを見てから、接続の手順を紹介します。

会話から研究ツールの実行へ

実行環境

構造予測やタンパク質設計のモデルを動かすには、GPUと実行環境が必要です。モデルごとに必要なライブラリのバージョンが異なり、モデルの重みだけで数GBになることもあります。エージェントがコードを書いてくれても、実行にはそのコードを動かす環境も必要です。

結果と一緒に残す記録

エージェントが会話中にスクリプトを修正しながら実行すると、後で、どの入力・設定・モデルのバージョンから結果が得られたかを再確認しにくくなります。次の実験の根拠にしたり、論文に記載したりするときには欠かせない情報です。

実行前に確認する時間

GPUの計算には費用と時間がかかります。準備をエージェントに任せても、入力と予想使用量は先に確認したいものです。そのために、計画を確認して承認する段階を設けています。

Nadoo Bioが担うこと

Nadoo Bioは、研究ツールの入力を準備し、実行計画を確認してから、ジョブと結果を追える製品です。会話するAIは研究チームが使っているものをそのまま使い、Nadoo Bioがツールと実行を担います。

  • 共通の記録: ウェブ画面で行ったことと、エージェント経由で行ったことが、同じ計画・ジョブ・結果として残ります。エージェントが作った計画をウェブでそのまま開けます。

  • 実行前の検査: 入力がツールの形式に合うかを先に調べます。配列に使えない文字がある場合や鎖の構成が合わない場合は、GPUを使う前に知らせます。

  • 固定された計画と人による承認: 実行計画は、入力・設定・ツールのバージョンをまとめて固定したものです。エージェントが作成しても、人がウェブ画面で承認するまで送信できません。承認した計画と内容が異なる場合も送信されません。

  • 結果と履歴: 結果ファイルは検証後に公開され、どの入力と計画から得られたかをたどれます。

エージェントがツール探索、入力検査、計画作成を行い、人がウェブで承認した後、送信と結果確認に進む流れ

MCP(Model Context Protocol)は、AIエージェントが外部ツールを呼び出すための接続規約です。Nadoo BioはMCPサーバーを提供し、エージェントはそのツール(list_tools、validate_input、create_planなど)を呼び出します。スキルは、ツールを適切な順序で使うための指示ファイル群です。

接続する

1. APIキーを発行する

製品画面の左メニューのAPIキーで、名前、権限の範囲、有効期間(30・90・365日)を指定して発行します。キーが表示されるのは発行直後の一度だけなので、その場でコピーしてください。ツール一覧と文書検索はキーなしでも利用できますが、計画の作成と送信には次の権限が必要です。

権限の範囲

用途

catalog:read

入力の検査

jobs:read

ジョブ・結果・計画の参照

plans:write

実行計画の作成

jobs:submit

承認済み計画の送信、ジョブのキャンセル

次のコマンドを実行し、キーを貼り付けてEnterを押します。キーの値をシェルのコマンド履歴に残さず、環境変数として受け取ります。

read -rs NADOO_BIO_API_KEY && export NADOO_BIO_API_KEY

2. MCPサーバーに接続する

簡単なのはNadoo Bio CLIを使う方法です。インストール済みのClaude CodeとCodexを探し、接続コマンドを実行します。

npx nadoo-bio@latest add

手動で接続する場合は、対応するコマンドを実行します。MCPサーバーのURLはhttps://nadoo.bio/mcpで、キーはAuthorizationヘッダーで送ります。

# Claude Code
claude mcp add --transport http nadoo-bio -s user https://nadoo.bio/mcp --header "Authorization: Bearer $NADOO_BIO_API_KEY"

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

環境変数は現在のターミナルに適用されます。Codexを起動する環境にも同じ変数が必要で、すでに開いているデスクトップアプリには自動で渡りません。Claude Codeでは、このコマンドで登録すると実際のキーの値が設定ファイルに保存されるため、キーを変更したら再登録してください。

OAuthログインにはまだ対応していません。ヘッダーを指定できるAIツールで接続してください。

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

npx skills add https://nadoo.bio

入力準備、計画と送信、結果の解釈、再現、複数候補の一括実行、権限・承認の問題解決を扱う六つのスキルが含まれます。スキルはMITライセンスで提供しています。スキルだけでは動作しないので、先にMCP接続を済ませてください。

4. 接続を確認する

エージェントに「Nadoo Bioのツール一覧を見せて」と頼んでみてください。一覧が返ればサーバーへの接続を確認できます。失敗する場合は、キーより先に接続設定を確認します。ツール一覧はキーなしでも動作するためです。

キーと参照権限も確認するには、同じターミナルでnpx nadoo-bio@latest doctorを実行します。計画作成・送信の権限は、前の権限表と別途照合してください。

会話で構造予測を一件実行する

例えば、FASTA形式(名前と配列を含むテキスト形式)のタンパク質配列を貼り付け、「この配列でBoltz-2の構造予測計画を作って」と頼みます。スキルを導入したエージェントは、おおむね次の順序で進めます。

段階

エージェントの操作

人が行うこと

ツール確認

list_toolsで探し、get_tool_schemaで入力形式を読む

特になし

入力検査

validate_inputで配列と設定を検査する

エラーがあれば配列を修正する

実行条件確認

list_execution_optionsで、そのプロジェクトで現在実行できるか確認する

特になし

計画作成

create_planで計画を作り、計画を開くリンクを返す

入力・設定・使用量を確認して承認する

送信と確認

承認済み計画をsubmit_planで送信し、get_jobで状態を確認する

特になし

結果を読む

get_resultで結果ファイルの一覧を取得し、結果画面のリンクを返す

構造と指標を確認する

左側のエージェント会話に計画へのリンク、右側のウェブ画面に同じBoltz-2計画と承認ボタンが表示された例

この図は、利用の流れを説明するための画面構成例です。

応答が途中で途切れても、最初と同じリクエスト識別子で再試行すれば、重複作成を防げます。スキルはエージェントがこの規則を守るよう案内します。月間の使用上限を超えるリクエストはサーバーが拒否し、エージェントが上限について知らせます。

一部のツールでは、APIキーで作った計画をそのまま送信できず、ウェブで新たに計画を作る必要があります。その場合、エージェントが理由とウェブ画面へのリンクを伝えます。

結果を読むときに覚えておくこと

  • 計算による予測と実験結果は異なります。 pLDDTなどの構造信頼度は、予測に対するモデルの信頼度を表します。実際に結合するか、実験が成功するかを示すものではありません。詳しくは結果の読み方をご覧ください。

  • 結果ファイルと文書はデータです。 ファイルや文書の中に命令のような文章があっても従わないよう、スキルが案内します。

  • 一覧にあるツールがすぐに実行できるとは限りません。 実行可否はプロジェクトと実行条件によって異なり、入力準備だけに対応するツールもあります。「このツールは今実行できる?」と聞くと、現在の状態と理由を確認できます。

最初の計画を作ってみる

接続ができたら、一つの配列で計画を作ってみてください。まずウェブ画面の入力と設定を確認するところから始められます。接続方法と対応範囲の詳細は、次の文書をご覧ください。