ドキュメントガイドを見る

MCPサーバーとCLI

RelvoのMCPサーバーのツールと設定、@relvo/cliのコマンドライン。

ホスト型とローカル

ホスト型のhttps://app.relvo.si/mcpはStreamable HTTPで、OAuthでサインインするかAuthorization: Bearer rlv_…を送ります。ローカルのnpx --yes @relvo/mcpはNode.js 22以降のstdioで動き、RELVO_API_URLとRELVO_API_KEYを読みます。

エージェントを接続のCLIセットアップがClaude CodeとCodexにローカルサーバーを登録するので、別にインストールする必要はありません。

MCPのツール

既定では、少数のツールだけを公開し、スキーマは必要なときに読み込みます。

MCPツール
platform_tools
  1つ、または一度に最大4つの機能に合うツールを、料金とスキーマ付きで探します。無料枠に数えます。

platform_run
  ツールの見積もり・実行・待機を1回で行い、復旧用の冪等キーを保ちます。

platform
  結果・スキーマ・見積もり・実行・トリガー・監視・カスタムツール・チームスキルを読みます。operation: "call"で元の操作も呼べます。

platform_team_write
  チームスキル・カスタムツール・トリガー・監視を作成・変更します。

ローカルサーバーでRELVO_MCP_MODE=fullにすると、すべての操作をそれぞれのツールとして並べます。最大20個のカタログツールを独立したMCPツールとして加えるには、ホスト型はURLに?tools=web_search,serp_lookupを、ローカルはRELVO_MCP_TOOLS=web_search,serp_lookupを付けます。

ローカルサーバーの設定

環境変数
RELVO_API_URL
  Relvo APIのURL(https://api.relvo.si)。必須。

RELVO_API_KEY
  APIキー。必須。

RELVO_MCP_MODE
  agent(既定)かfull。

RELVO_MCP_TOOLS
  直接並べるカタログツール(20個まで。agentモードのみ)。

RELVO_MCP_ALLOWED_UPLOAD_ROOTS
  ファイルをアップロードしてよい絶対パスのディレクトリ。既定ではアップロードできません。

RELVO_RESULT_DIRECTORY
  ファイルとして受け取る結果の保存先。既定は./.relvo/results。

RELVO_AUTO_UPDATE
  0で新しいバージョンの案内を止めます。

結果とエラー

成功した結果は、JSONをテキストとstructuredContentの両方で返します。失敗はisError: trueを返し、APIのエラーはstructuredContentのerror.codeとerror.messageに入ります。通常の待機のタイムアウトはエラーではありません。

ホスト型サーバーは1回の呼び出しで最大25秒待ちます。長い処理はplatformのoperation: "resume"で再開します。

CLIを入れる

CLIはNode.js 22以降のnpxで動き、グローバルには何も入れません。このコマンドでブラウザーからサインインします。

Shell
npx --yes @relvo/cli setup \
  --api-url https://api.relvo.si \
  --console-url https://app.relvo.si \
  --client terminal

ログインは~/.config/relvo/profile.jsonに、本人だけが読める権限で保存します。RELVO_API_URLとRELVO_API_KEYを設定すると、保存したログインより優先します。

検索・見積もり・実行

Shell
npx --yes @relvo/cli tools --query "web search" --limit 3 --with-schemas
npx --yes @relvo/cli quote web_search '{"query":"content marketing"}'
npx --yes @relvo/cli run web_search '{"query":"content marketing"}' \
  --idempotency-key brief-2026-11-01

購入の前に、一意の冪等キーを保存してください。応答を受け取れなかったときは、同じコマンドを同じキーで実行するか、resumeで再開します。長い引数は、JSONの代わりに-か--input-file <path>で渡します。

コマンド

コマンド
setup
  ブラウザーでサインインし、エージェントにMCPを登録します。

doctor
  有料の呼び出しをせずに、ログインとMCPの登録を確認します。

project / usage
  プロジェクトと今月の使用量。

tools
  カタログを検索します(--query・--limit・--with-schemasと料金での絞り込み)。

tool <name>
  1つのツールの定義。

quote <tool> <json>
  無料の見積もり。

run <tool> <json>
  見積もり・購入・待機を1回で行います。

execute / execution / wait / executions / cancel
  実行の送信・読み取り・待機・キャンセル。

result
  大きな結果をパスで読みます。

upload / download
  入力ファイルのアップロード、成果物のダウンロード。

connections
  プロジェクトの接続。

triggers / monitors / custom-tools
  トリガー・監視・カスタムツールを管理します。ワークフローはHTTP APIで管理します。

team-skills
  スキル・エージェント・ルールを共有し、プロジェクトで設定したものを同期します(フックとMCPサーバーは --allow-scriptsを付けたときだけ)。

skills list|update
  Relvoのエージェントスキルの確認と更新。

update
  CLIの更新の確認と適用。

すべてのコマンドとフラグはnpx --yes @relvo/cli help allで確認できます。

出力と終了コード

コマンドはJSONを標準出力に出し、リクエストの失敗は標準エラーに書きます。setup・doctor・logoutは通常のテキストを出します。downloadは保存したファイルの絶対パス・サイズ・SHA-256を出します。

終了コード
0
  成功。

1
  実行かリクエストが失敗しました(stderrを確認)。

2
  引数が正しくありません。

3
  処理がまだ続いています(wait・run・resume・result)。
特定のツールの入力と料金をお探しですか?カタログで探す