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のツール
既定では、少数のツールだけを公開し、スキーマは必要なときに読み込みます。
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で動き、グローバルには何も入れません。このコマンドでブラウザーからサインインします。
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を設定すると、保存したログインより優先します。
検索・見積もり・実行
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)。