MCP の料金と承認
このページは、リリース済みの MCP 1.12.1 を対象としています。estimate_cost を呼び出してから、モデル、最終的な入力、出力の数、見積もり額を示してください。生成ツールを呼び出すのは、このタスクが明確に承認されてからにしてください。ユーザーが、このタスク、バッチ、または会話の残り全体について、見積もりや確認は不要だと明確に述べた場合、アシスタントは代わりに skip_estimate: true を付けて送信します。見積もりなしで生成するを参照してください。
見積もりの状態、公開価格に基づくことによる制限、承認、予算については、モデル、料金、クォータを参照してください。リリース済みの max_cost_usd は、送信前の見積もりと比較するだけで、最終的な請求額に上限を設けるものではありません。
estimate_cost は max_cost_usd を受け付けません。生成ツールは受け付けます。
ネイティブ MCP には、CLI のようなローカルの quote_id と --confirm コマンドも、セッション単位のサーバー側承認ボタンもありません。エージェントは、このタスクのモデル、入力、見積もり、承認を保持する必要があります。入力が変わった場合、価格が上がった場合、承認の有効期限が切れた場合は、改めて承認が必要です。承認(pricing_quote)は、承認済みの価格以下である限り、見積もりから24時間有効です。生成ツールはもう一度見積もりを行い、価格が変わっていないか下がっていれば、その後に価格ルールが変更されていても送信します。価格が上がっていれば price_changed、入力が変わっていれば quote_input_changed、承認が expires_at を過ぎていれば quote_expired が返されます。ホストのツール権限、アカウントの認証、購入の承認は、互いに代わりになるものではありません。
モデル、残高、タスクの照会では、生成は送信されません。生成は課金されます。ファイルサービスの制限は、別途適用されます。失敗したタスクは課金されず、送信時に仮押さえされたクレジットは自動的に返還されます。タイムアウトしたことやチャットを閉じたことは、課金が発生しなかったことや、返金が完了したことの根拠にはなりません。使用量の照会は、完全な精算の領収書ではありません。
共通のアクセスルールを参照してください。このページには、このルートでのログインとログアウトの操作を記載しています。
認証、権限、クォータ
リモート MCP は、Passport によるブラウザの OAuth を使います。接続用の認証情報はホストが保存し、サービスは OAuth に紐付いた既存のキーを使います。リモート MCP と CLI は、アカウントへのアクセス、キーのクォータ、権限を共有できます。共有されているキーを一時停止すると、それを使うすべての利用元に影響します。ホストのセッションからのログアウトは、別の操作です。 ローカル stdio は、その MCP プロセスに渡された個人用の API Key を使い、そのキーの権限とクォータに従います。キーをチャットに貼り付けないでください。また、CLI にログインしていることを、ネイティブ MCP が認証済みであることの証拠として扱わないでください。 切断やログアウトは、ホストの MCP 設定またはコネクタ設定から行ってください。必要に応じて、アカウントの認証管理から、アカウントの認証を取り消してください。ウィンドウを閉じても、アクセスが取り消されるとは限りません。残高不足、1日のクォータや合計クォータ、モデルの権限の問題は、アカウント設定で解決してください。保存と有効期限
見積書、参照素材、アップロード許可、オリジナルの URL のデフォルトの有効期間は、タスク、参照素材、結果にまとめています。実際に返された値が優先されます。レシートに対応しているかどうかは、ファイルサービスのデプロイ環境によって異なります。MCP のトラブルシューティング:接続の種類を特定する
リモート MCP は、https://mcp.evolink.ai/mcp、Streamable HTTP、ホストでの OAuth ログインを使います。ローカル stdio は、ホストで設定された @evolinkai/mcp プロセスと、プラットフォームのキーを使います。実際に使っている接続について、認証情報とツールの検出を確認してください。
このホストの接続が有効で認証済みであること、ツールが表示されていることを確認してから、実際に
check_balance を呼び出してください。リモート MCP は16個、ローカル stdio は14個のツールを提供します。CLI が成功しても、ネイティブ MCP にアクセスできることの証明にはなりません。また、MCP のトラブルシューティングに CLI のインストールは必要ありません。
ブラウザでのログインと認証
1
ホストから認証を開始する
この MCP またはコネクタの項目にある、ログインまたは認証の操作を使います。ホストのコマンドやメニューは、そのホスト専用のガイドで確認してください。別の CLI にログインしても、この接続は認証されません。
2
ブラウザでアカウントの承認を完了する
正しい EvoLink アカウントにログインし、スコープを確認して、承認します。ホストの認証フローは、待機させたままにしてください。認証 URL の全体や、コールバックのパラメータを共有しないでください。フローが失敗した場合は、元のホストからやり直します。
3
ホストに戻って検証する
接続のツールを再読み込みし、
check_balance と search_models があることを確認して、実際に残高を照会します。401 の場合は、再認証してください。403 の場合は、アカウントの権限、キーの状態、ホストのツール権限も確認してください。スキルはインストールされているのに、ツールが使えない
evolink-mcpのツール向けの説明を読んでください。ネイティブ MCP は、CLI スキルにあるターミナルコマンドを実行できません。- ホストで、実際のサーバー設定とツールを確認してください。スキルを読んでもサーバーは登録されず、プラグインをインストールしても OAuth が自動的に完了するわけではありません。
- セッションまたはプラグインを再読み込みし、ツールの権限を確認してください。説明があっても、ツール呼び出しの記録がなければ、アクセスできることの証明にはなりません。
- ツールが一覧に表示されるのに呼び出しが失敗する場合は、ツールのエラーと元の接続を確認してください。有料生成を接続テストとして使わないでください。
MCP の接続とアクセス:ツールがない、接続の失敗、401/403
- 接続の種類を確認します。リモートは、
https://mcp.evolink.ai/mcp、Streamable HTTP、OAuth を使います。ローカル stdio は、起動コマンドと個人用のキーを使います。ドキュメントのページ、llms.txt、REST のエンドポイントは、MCP サーバーではありません。 - EvoLink を有効にし、このホストでのブラウザ認証を完了してから、再読み込みするか、新しいセッションを開きます。既存の設定をバックアップし、EvoLink の部分だけをマージしてください。ほかのサービスの設定を上書きせずに、JSON の引用符とカンマ、YAML の空白、設定のスコープを確認します。
check_balanceとsearch_modelsを呼び出します。ツールが一覧に表示されるのに呼び出しが失敗する場合は、認証を確認してください。残高の照会はできるのに生成ツールがない場合は、ツールのオン/オフの設定と、ワークスペースのポリシーを確認してください。
設定ページ:ChatGPT、Claude、Claude Code、Codex、Cursor、OpenClaw、Hermes、その他のクライアント。
モデルと価格:検索結果が空、パラメータが無効、見積もりが不完全
- 現在提供されているモデルを検索し、返された正式な ID を使います。シリーズ名、表示名、エイリアスは、有効な送信用 ID ではない場合があります。必要な参照素材への対応という条件は外さずに、検索の言い回しを広げてください。
- このモデルについて、MCP の
get_modelを確認します。必須項目、スペル、列挙値、数値の制限、同時に指定できない参照素材を確認してください。ほかのモデルのduration、size、qualityフィールドをコピーしないでください。 - 見積もりをやり直し、
input_valid、problems、estimate.status、basis、warningsを確認します。入力またはアカウントが変わった場合、価格が上がった場合、承認の有効期限が切れた場合は、新しい見積もりと承認が必要です。
needs_input の場合は、不足している入力を補うか、missing_usage と usage_help に示された課金使用量を media_seconds または pricing_parameters で指定してください。no_price は利用できず、partial は合計額ではありません。長さや参照素材の倍率が不明な場合に、開始価格で埋めることはできません。予算は維持してください。拒否を回避するために、断りなく上限を外したり、キーを切り替えたり、仕様を下げたりしないでください。
search_models、get_model、recommend_models のどのモデルにも価格がなく、pricing_warning に Public pricing rules are unavailable or invalid と表示される場合、サーバーは 1.8.1 以前のバージョンです。これらのバージョンでは、段階制ルールに multiplier がないと、すべての価格が表示されなくなります。リモート MCP ではより新しいバージョンが動作しているため、ツールをもう一度呼び出してください。npx -y @evolinkai/mcp@latest で設定されたローカル stdio は、クライアントを再起動すると新しいバージョンを取得します。1.8.2 以降では、ルールを読み取れないモデルは除外されて pricing_warning に示され、ほかのモデルの価格はそのまま表示されます。
estimate_cost または get_pricing_rules が、秒数とともに rate_limited(pricing_calls_per_minute)を返した場合は、その秒数だけ待ってから、もう一度呼び出してください。ホスト型サービスでは、ログイン中のアカウントごとに、これら2つのツールのそれぞれについて、価格ルールを毎分30回まで読み取れます。直前に読み取ったルールから返された回答は、回数に数えられません。同じモデルの複数の入力は、入力ごとに呼び出すのではなく、inputs を使って一度の呼び出しで見積もってください。プラットフォーム自体が価格の読み取りを制限している場合、見積もりには過去10分以内に読み取ったルールが使われ、それがいつ読み取られたものかが示されます。ローカル stdio には、このような制限はありません。
リリース済みバージョンの、公開デフォルト価格に基づく見積もりは、アカウント固有の正式な見積書(Quote)ではなく、max_cost_usd も最終的な精算額の上限ではありません。料金とコマンド/ツールのリファレンスを参照してください。
タイムアウト、実行中のタスク、結果不明
1
元のタスクを保持して照会する
既存の
task_id に対して get_task を呼び出します。時間を区切って待機するには、wait_seconds を 0–45 に設定します。ID が複数ある場合は、list_tasks を使います。タイムアウトで終了するのはその待機だけで、生成は終了しません。読み取りが status_check: unverified を返した場合(task_response_invalid、task_identity_mismatch、task_status_unknown、task_query_timeout のいずれか、または待機中のあとの読み取りが失敗したときの last_known_status)は、同じタスクをもう一度照会してください。これは失敗ではありません。submission_state: accepted の generate の結果には、すでに task_id があります。2
結果不明の送信を、元のリクエスト ID で復旧する
タスク ID が返されなかった場合は、
client_request_id、入力、アカウント、エラーを保持してください。同じツールと同じリクエスト ID で復旧します。アカウントやリクエスト ID を変えて生成し直さないでください。EvoLink はリクエスト ID を24時間保持します。その間は、同じリクエスト ID と同じ入力であれば元のタスクが返され、新たな課金は発生しません。バッチの場合は、結果の中で完了させるべきものとして示された項目だけが送信されます。その時点で承認の有効期限が切れている場合は、同じ入力をもう一度見積もり、新しい pricing_quote を同じリクエスト ID とともに渡してください。24時間を過ぎると、そのリクエスト ID があっても重複するタスクの作成は防げなくなります。まず list_tasks で確認し、通らなかったものだけを、新しい見積もりと新しいリクエスト ID で送信してください。list_tasks が受け付けるのは、ドキュメントに記載されたパラメータだけです。勝手に作ったフィルターは受け付けません。3
失敗とアカウント上の結果を、別々に確かめる
実際のエラーと時刻を記録し、元のタスクとアカウントの使用量を照会してください。失敗したタスクは課金されず、送信時に仮押さえされたクレジットは自動的に返還されます。結果不明の送信は失敗ではなく、課金されていないことの証明にもなりません。キューをキャンセルするための、利用できる公開ツールはありません。MCP を切断したりページを閉じたりしても、タスクはキャンセルされません。
添付ファイルを読み取れない、アップロードの失敗、結果不明
- 渡されたファイルをホストが読み取れることを確認してください。リモート MCP はデスクトップ上のパスを直接読み取れず、チャットの添付ファイルが、そのままモデル用の URL になるわけでもありません。
- アクセス可能な URL には、
upload_file.file_urlを使います。リモートの base64 は、1 MiB までです。それより大きなファイルは、prepare_uploadを呼び出し、ファイルにアクセスできる環境からアップロードしてから、get_uploadを呼び出します。1回限りのアップロードでは、最大 95 MiB まで扱えます。許可の有効期間は約15分、状態の保持期間は約1時間です。 - ローカル stdio では、MCP プロセスが動作するマシン上の
upload_file.file_pathを使えます。パス、権限、形式、ファイルサービスの制限、モデルの制限を確認してください。デスクトップ上のパスが、クラウドのホストからそのまま読み取れるわけではありません。 - 元の
upload_idを保持し、それを照会してください。結果が不明であることは、何もアップロードされなかったという意味ではありません。レシートの互換性は、ファイルサービスのデプロイ環境によって異なります。代わりのアップロードは、失敗または失効が確定してから要求してください。参照素材の有効期間は、通常72時間です。失効した入力は、再アップロードしてください。