アンチグラビティ CLI + スクラペレス：リモート MCP サーバーを追加する

Michael Lee

Expert Network Defense Engineer

21-Sep-2026

TL;DR:

Antigravity CLIは、ScrapelessにリモートMCPサーバーとして接続します。 agy mcp addで追加された、serverUrlとx-api-tokenのヘッダーを持つ1つのエントリが全体のセットアップです。
ヘッダー自体にキーを書き込みます。 ${SCRAPELESS_API_KEY}の参照はリテラルテキストとして送信され、すべてのツール呼び出しは、成功を報告するランの中で401で失敗します。
agy mcp listは構成を示し、動作する接続ではありません。 サーバーはenabledがそのキーが有効かどうかを読み取ります。
ヘッドレスランには許可ルールが必要です。 MCPツールはAskモードで起動し、agy -pは質問できないため、呼び出しを拒否します。mcp(scrapeless/scrape_markdown)はpermissions.allowで、その1つのツールを実行させます。
ヘッダー名はx-api-tokenです。 Scrapelessは、401 Unauthorized: Missing x-api-token headerなしのリクエストに応答します。
Scrapelessの無料プランでキーを取得し、数分で接続できます。

Antigravity CLI、agyコマンドは、ターミナルからGoogleのAntigravityエージェントを実行し、Googleが今、個人アカウントでGemini CLIを使用していた人々を送る場所です。エージェントはファイルを読み取り、コマンドを実行し、ウェブを検索できます。Scrapeless MCPサーバーは、クラウドブラウザでレンダリングされたページを追加し、Markdownとして返します。エージェントはステップバイステップで運転できるブラウザセッション、バックグラウンドクローリング、Googleの結果データを持っています。

このガイドは、Antigravity CLIにホストされたサーバーを追加し、スクリプトから1つのツール呼び出しを実行します。構成は短いです。うまく機能するかどうかを決める3つの詳細は、キーの書き方、信頼すべきステータスライン、ヘッドレスランが必要とする許可ルールです。

What Scrapeless Adds to Antigravity CLI

サーバーは、仕事別にグループ化された25のツールを公開しています：

scrape_markdown、scrape_html、scrape_screenshotは1回の呼び出しでMarkdown、プレーンHTML、または画像としてレンダリングされたページを返します。
browser_*ツール16個が、browser_create、browser_goto、browser_click、browser_type、browser_snapshotを含んで、クラウドブラウザセッションをステップバイステップで駆動します。
crawl_start、crawl_result、crawl_cancelはバックグラウンドでクロールを実行し、後でそれを収集します。
google_search、google_trendsは検索結果とトレンドデータを返し、ai_scraperはChatGPT、Gemini、PerplexityなどのAIアシスタントからの回答をキャプチャします。

Antigravity CLIは~/.gemini/antigravity-cli/mcp/scrapeless/の下に各ツールのスキーマのコピーを保持し、テスト中にエージェントはツールを呼び出す前にscrape_markdownスキーマを読みました。

代わりにAntigravityデスクトップアプリを使用する場合、私たちのAntigravity IDEガイドでそのセットアップをカバーしています。

Where Antigravity CLI Reads MCP Servers

GoogleのAntigravity用MCPドキュメントは、~/.gemini/config/mcp_config.jsonに構成を置き、.agents/mcp_config.jsonにローカル代替としてワークスペースファイルがあります。このガイドは、以下のテストが参照するグローバルファイルを使用します。リモートサーバーは2つのプロパティを取得します：

serverUrl、リモートStreamable HTTPまたはSSEサーバーのURL。
headers、そのサーバーに送信されるカスタムHTTPヘッダー。

Scrapelessはhttps://api.scrapeless.com/mcpのStreamable HTTPエンドポイントであるため、トランスポート設定は必要ありません。

Prerequisites

GoogleアカウントでサインインしたAntigravity CLI。このガイドでは、個人のGoogleアカウントでLinux上のagy 1.2.2を使用しました。
ScrapelessダッシュボードからのScrapeless APIキー。

Step 1: Add the Server

agy mcp addがエントリを書き込みます。フラグはサーバー名の前に置き、httpsのURLはHTTPサーバーとして検出されます：

bash Copy

agy mcp add -H "x-api-token: YOUR_SCRAPELESS_API_KEY" scrapeless https://api.scrapeless.com/mcp

それは応答します：

text Copy

Added MCP server "scrapeless" (http)

そしてこのエントリを~/.gemini/config/mcp_config.jsonに書き込みます：

json Copy

{
  "mcpServers": {
    "scrapeless": {
      "disabled": false,
      "headers": {
        "x-api-token": "YOUR_SCRAPELESS_API_KEY"
      },
      "serverUrl": "https://api.scrapeless.com/mcp"
    }
  }
}

このコマンドは、キーをシェル履歴に保存します。それを避けるために、同じエントリをエディタでファイルに書き込み、その後、chmod 600 ~/.gemini/config/mcp_config.jsonでファイルへのアクセスをユーザーに制限します。

今これを設定していますか？ Scrapelessの無料プランが接続と最初のツール呼び出しをカバーします。

いくつかのMCPクライアントは、構成ファイル内で環境変数を展開し、ここで"x-api-token": "${SCRAPELESS_API_KEY}"を書くのは魅力的です。しかし、Antigravity CLIはそれを展開しません。ファイル内にその値があり、変数がエクスポートされると、scrape_markdownを要求したランが次のように応答しました：

text Copy

Failed to fetch data. Error: [Scrapeless]: Request POST https://api.scrapeless.com/api/v1/unlocker/request failed with status 401

実行自体は依然として "status": "SUCCESS" を報告しました。Scrapelessはリテラルテキスト ${SCRAPELESS_API_KEY} を受け取り、ヘッダー値のために接続を受け入れ、ツールコールを拒否しました。ヘッダーにキー自体を記述し、ファイルを保護してください。

ステップ 3: サーバーリストを確認する

CLIが読み込むもののリスト:

bash Copy

agy mcp list

text Copy

NAME        TYPE  STATUS   COMMAND/URL
scrapeless  http  enabled  https://api.scrapeless.com/mcp

enabled は、エントリが存在し、オフになっていないことを意味します。コマンドは瞬時に返され、キーを確認することはできなかったので、カウントされるチェックはステップ 5 のツールコールです。

ステップ 4: ヘッドレス実行前にツールを許可する

Antigravityは、ルールがないMCPツールを実行する前に尋ねます。Antigravityの権限リファレンスは、デフォルトでAskの下にMCPツールをリストし、mcp(server/tool)、mcp(server/*) または mcp(*)と一致させます。インタラクティブセッションでは、承認プロンプトを意味します。印刷モードの実行には尋ねる人がいないため、コールを拒否し、次のように印刷します:

text Copy

jetski: no output produced — a tool required the "mcp" permission that headless mode cannot prompt for, so it was auto-denied. Add an allow-rule under permissions.allow in settings.json (e.g. mcp(<target>)). Alternatively, re-run with --dangerously-skip-permissions to auto-approve all tools.

そのJSON出力は、denied_actionsの下にコールをCallMcpToolとしてリストします。あなたのスクリプトが必要とするツールのために、~/.gemini/antigravity-cli/settings.jsonにルールを追加してください。すでにそこにあるルールの隣に配置します:

json Copy

{
  "permissions": {
    "allow": ["mcp(scrapeless/scrape_markdown)"]
  }
}

--dangerously-skip-permissions のようなルールよりもこのようなルールを好みます。これはすべてのツール、ファイル、コマンドアクションを実行のために承認します。mcp(scrapeless/*)は、すべての25のScrapelessツールを許可します。CLIのリポジトリに関するオープンレポート、Antigravity CLI issue 548は、印刷モードが permissions.allow を無視することを説明しています。agy 1.2.2では、上記のルールが読み込まれ、適用されました：CLIログは起動時にそれをリストし、コールは通過しました。

ステップ 5: 1つのツールコールを実行する

印刷モードで小さくて確認可能なジョブを要求します:

bash Copy

agy -p "Call the scrapeless MCP server's scrape_markdown tool with url https://example.com and reply with the first Markdown heading, verbatim." --output-format json

JSON出力は、response の中に答えを持ちます:

text Copy

"status": "SUCCESS"
"response": "# Example Domain\n"

Antigravityの会話記録は、エージェントがそこに至った経緯を示しています：キャッシュされた scrape_markdown スキーマを読み取り、その後 scrape_markdown を https://example.com に対して呼び出しました。実行はそれぞれ2分ちょっとかかり、タイミングを計ったステップでは、ツールコール自体が約5秒かかりました。

response テキストを読み、status を読みません。間違ったキー、間違ったヘッダー名、または未展開の変数はまだ SUCCESS を生成し、テキストは Failed to fetch data で始まります。

一般的な問題を修正する

あなたが見るもの	原因	修正
`response` が `Failed to fetch data … 401` で始まる	キーが間違っているか、ヘッダーが `${SCRAPELESS_API_KEY}` を保持している	`headers` にキー自体を記述する
空の `response` および `denied_actions` リスト `CallMcpTool`	ヘッドレス実行のツールに対する許可ルールがない	`mcp(scrapeless/scrape_markdown)` を `permissions.allow` に追加する
エージェントがScrapelessを呼び出すことなく応答する	代わりに組み込みのウェブツールを使用しました	プロンプトにサーバーとツールの名前を指定する
`agy mcp add` がヘッダーフラグを拒否する	フラグがサーバー名の後にきた	`-H` を `scrapeless` の前に置く

サーバー自体についての詳細は、Scrapeless MCPサーバー発表を読んでください。ブラウザーMCPドキュメントには設定リファレンスが載っており、スクレイピングAPIページはツールの背後にいるアクターをカバーし、価格設定にはコールにかかる費用がリストされています。

結論

ScrapelessをAntigravity CLIに追加するには、~/.gemini/config/mcp_config.jsonに1つのエントリーが必要です：serverUrl を https://api.scrapeless.com/mcp に設定し、キー自体を保持する x-api-token ヘッダーを追加します。agy mcp add -H はそれを1行で書き込み、スクリプト実行にはツールごとに1つの許可ルールが必要です。

2つの結果は見栄えがよく、実際にはそうではありません。サーバーリストの enabled はキーについて何も言及しておらず、悪いキーまたは未展開の変数付きの実行は、成功を報告します。ツールの回答を読み、設定が証明されます。

Antigravityのエージェントにウェブのライブビューを提供する準備はできましたか？Scrapelessの無料プランで開始し、サーバーを追加してください。

FAQ

Q: Antigravity CLIにAPIキーヘッダーを持つリモートMCPサーバーを追加するにはどうすればよいですか？

agy mcp add -H "x-api-token: YOUR_KEY" scrapeless https://api.scrapeless.com/mcp を実行するか、serverUrl と headers オブジェクトを ~/.gemini/config/mcp_config.json に追加してください。フラグはサーバー名の前に来る必要があります。
Q: Antigravity CLIはMCPヘッダー内の環境変数を展開しますか？

このセットアップではしません。${SCRAPELESS_API_KEY}のヘッダー値はリテラルテキストとして送信され、ツール呼び出しは401エラーで失敗しましたが、実行は成功として報告されました。キーをファイルに入れ、ファイルの権限を制限してください。

Q: なぜagyは印刷モードで私のMCPツール呼び出しを拒否するのですか？

MCPツールはデフォルトでAskモードで実行され、印刷モードではプロンプトを表示できないため、呼び出しは自動的に拒否され、denied_actionsの下にリストされます。mcp(server/tool)をpermissions.allowに~/.gemini/antigravity-cli/settings.jsonで追加してください。

Q: agy mcpリストの有効は接続が機能していることを意味しますか？

いいえ。それはエントリーが存在し無効ではないことを意味します。ページコンテンツを返すツール呼び出しがチェックになります。

Q: 代わりにGemini CLIを使用できますか？

Gemini CLIはもはや個人のGoogleアカウントにサービスを提供しておらず、GoogleはこれをAntigravityに誘導しています。Antigravity CLIは~/.gemini/config/mcp_config.jsonからMCPサーバーを読み取ります。

Q: ScrapelessはAntigravity CLIにいくつのツールを追加しますか？

25: 3つのscrape_*ツール、16のbrowser_*ツール、3つのcrawl_*ツール、さらにgoogle_search、google_trends、ai_scraperです。

Scrapelessでは、適用される法律、規制、およびWebサイトのプライバシーポリシーを厳密に遵守しながら、公開されているデータのみにアクセスします。このブログのコンテンツは、デモンストレーションのみを目的としており、違法または侵害の活動は含まれません。このブログまたはサードパーティのリンクからの情報の使用に対するすべての責任を保証せず、放棄します。スクレイピング活動に従事する前に、法律顧問に相談し、ターゲットウェブサイトの利用規約を確認するか、必要な許可を取得してください。