スプレッドシートの MCP サーバーを構成する

Google スプレッドシートには、AI エージェントが Google スプレッドシートのデータを安全に操作できるリモート Model Context Protocol（MCP） サーバーが用意されています。 Google スプレッドシート MCP サーバーを構成すると、Google Antigravity や Claude などの AI アプリケーションで Google スプレッドシートの操作を実行できます。

Google スプレッドシート MCP サーバーを使用すると、AI エージェントは次の操作を標準化された方法で実行できます。

  • データの読み取り: セルの値、シート名、グリッド プロパティ、その他のスプレッドシート メタデータを取得します。
  • 実践: セルの値の更新、数式の設定、行/列の挿入、スプレッドシートの構造の一括更新を行います。
  • セキュリティの尊重: ユーザーと同じ権限とデータガバナンス コントロールを継承します。

前提条件

Google スプレッドシート MCP サーバーを構成する

Google スプレッドシート MCP サーバーを使用するには、Google Cloud プロジェクトで有効にしてから、MCP クライアントを構成して接続する必要があります。

API を有効にする

Google スプレッドシート MCP サーバーを使用するには、Google Cloud プロジェクトで次の API を有効にする必要があります。

  • Google Sheets API

CLI

gcloud services enable sheets.googleapis.com --project=PROJECT_ID

PROJECT_ID を実際の Google Cloud プロジェクト ID に置き換えます。

Console

Google Cloud コンソールで API を有効にします。

API を有効にする

MCP サービスを有効にする

Google スプレッドシートの MCP コンポーネントを有効にするには、Google Cloud プロジェクトで次のサービスを有効にする必要があります。

  • Google Sheets MCP API

CLI

gcloud services enable sheetsmcp.googleapis.com --project=PROJECT_ID

PROJECT_ID を実際の Google Cloud プロジェクト ID に置き換えます。

Console

Google Cloud コンソールで MCP サービスを有効にします。

MCP サービスを有効にする

Google スプレッドシート MCP サーバーは、認証と認可に OAuth 2.0 を使用します。OAuth クライアント ID を作成する前に、OAuth 同意画面を構成する必要があります。

  1. Google Cloud コンソールで、Google Auth Platform > Branding に移動します。

    [ブランディング] に移動

  2. すでに [Google Auth Platform] を構成している場合は、 [ブランディング]、 [対象]、 および [データアクセス] で次の OAuth 同意画面の設定を構成できます。 [**Google Auth Platform はまだ構成されていません**] というメッセージが表示されたら、[**使ってみる**] をクリックします。

    1. [アプリ情報] の [アプリ名] に Sheets MCP Server と入力します。
    2. [**ユーザー サポートメール**] で、メールアドレスまたは適切な Google グループを選択します。
    3. [次へ] をクリックします。
    4. [対象] で [内部] を選択します。[**内部**] を選択できない場合は、 [**外部**] を選択します。
    5. [次へ] をクリックします。
    6. [連絡先情報] で、プロジェクトに対する変更の通知を受け取ることができる [メールアドレス] を入力します。
    7. [次へ] をクリックします。
    8. [完了] で、Google API サービスのユーザーデータに関するポリシー を確認し、同意する場合は [Google API サービス: ユーザー データに関するポリシーに同意します] を選択します。
    9. [続行] をクリックします。
    10. [作成] をクリックします。
    11. ユーザータイプとして [外部] を選択した場合は、テストユーザーを追加します。
      1. [対象] をクリックします。
      2. [テストユーザー] で [ユーザーを追加] をクリックします。
      3. メールアドレスと他の承認済みテストユーザーを入力し、[保存] をクリックします。

  3. [データアクセス] > [スコープの追加または削除] をクリックします。パネルが開き、Google Cloud プロジェクトで有効にした各 API のスコープのリストが表示されます。

    1. [**スコープの手動追加**] で、Google スプレッドシート MCP サーバーのスコープを貼り付けます。

      • https://www.googleapis.com/auth/drive.readonly
      • https://www.googleapis.com/auth/drive.file
      • https://www.googleapis.com/auth/spreadsheets.readonly
      • https://www.googleapis.com/auth/spreadsheets

    2. [テーブルに追加] をクリックします。

    3. [更新] をクリックします。

    4. アプリに必要なスコープを選択したら、[データアクセス] ページで [保存] をクリックします。

MCP クライアントを構成する

Google スプレッドシート リモート MCP サーバーを MCP クライアントに追加するには、クライアントの手順に沿って操作します。

Antigravity

Google スプレッドシート リモート MCP サーバーを Antigravity に追加するには、サーバー構成を mcp_config.json ファイルに追加します。この手順は、Antigravity 2.0、Antigravity IDE、Antigravity CLI をサポートしています。

  1. OAuth 2.0 クライアント ID とシークレットを作成します。

    1. Google Cloud コンソールで、Google Auth Platform > クライアント > クライアントを作成 に移動します。

      [クライアントを作成] に移動

    2. アプリケーションの種類として [ウェブ アプリケーション] を選択します。

    3. 名前 を入力します。

    4. [承認済みのリダイレクト URI] セクションで、[+ URI を追加] をクリックし、 https://antigravity.google/oauth-callback を [URI] フィールドに追加します。

    5. [作成] をクリックして、クライアント ID とクライアント シークレット をコピーします。

  2. 構成ファイル ~/.gemini/antigravity/mcp_config.json を開くか、作成します。

  3. mcpServers 構成を mcp_config.json に追加します。

    {
  "mcpServers": {
    "sheets": {
      "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    }
  }
}

    次のように置き換えます。

    • OAUTH_CLIENT_ID: 作成したクライアント ID。
    • OAUTH_CLIENT_SECRET: 作成したクライアント シークレット。

  4. mcp_config.json を保存します。

  5. MCP サーバーを認証します。認証は、GUI 設定または CLI を使用して行うことができます。

    • Antigravity IDE または GUI（Antigravity 2.0）の場合:

      1. 設定画面を開きます（左下の [設定] をクリックするか、[Antigravity ユーザー設定] を開きます）。
      2. [カスタマイズ] に移動します。
      3. [インストール済み MCP サーバー] で [更新] をクリックします。
      4. リストで sheets を見つけて [**認証**] をクリックし、 Google アカウントにログインして認証コードをコピーし、 入力ダイアログに貼り付けて [**送信**] をクリックします。

    • Antigravity CLI の場合:

      1. Antigravity CLI を起動します。

        agy

      2. 次のコマンドを実行して、インタラクティブな MCP 管理パネルを開きます。

        /mcp

      3. 矢印キーを使用して sheets を選択し、[認証] アクションに移動して Enter キーを押します。ブラウザでログイン フローを完了し、認証コードをコピーしてターミナルのプロンプトに貼り付け、Enter キーを押します。

  6. サーバーが正しく構成され、実行されていることを確認します。

    • Antigravity IDE または GUI の場合: [カスタマイズ] > [インストール済み MCP サーバー] のサーバーの横に [ログアウト] ボタンが表示されます。
    • Antigravity CLI の場合: /mcp パネルを開いて、構成済みの MCP サーバーを表示します。検証および認証されたサーバーの名前の横には、インタラクティブな TUI パネル内に [Authed] と表示されます。 ダッシュボード ビューでサーバーを選択すると、そのステータスを確認し、利用可能なすべてのツールを一覧表示できます。

リモート MCP サーバーは Antigravity で使用できるようになりました。

Claude

Claude.ai または Claude Desktop で Google スプレッドシート リモート MCP サーバーを使用するには、Claude Enterprise、Pro、Max、または Team プランが必要です。

Google スプレッドシート リモート MCP サーバーを Claude に追加するには、OAuth クライアント ID とシークレットを使用してカスタム コネクタを構成します。

  1. OAuth 2.0 クライアント ID とシークレットを作成します。

    1. Google Cloud コンソールで、Google Auth Platform > クライアント > クライアントを作成 に移動します。

      [クライアントを作成] に移動

    2. アプリケーションの種類として [ウェブ アプリケーション] を選択します。

    3. 名前 を入力します。

    4. [承認済みのリダイレクト URI] セクションで、[+ URI を追加] をクリックし、 https://claude.ai/api/mcp/auth_callback を [URI] フィールドに追加します。

    5. [作成] をクリックして、クライアント ID とクライアント シークレット をコピーします。

  2. Claude で MCP サーバーを構成します。

    1. Claude.ai または Claude Desktop で、[設定]（または [管理設定]）> [コネクタ] に移動します。
    2. [カスタム コネクタを追加] をクリックします。
    3. Google スプレッドシート プロダクトの接続の詳細を入力します。
      • サーバー名: Google Sheets。
      • リモート MCP サーバーの URL: https://sheetsmcp.googleapis.com/mcp/v1
    4. [詳細設定] で、[OAuth クライアント ID] と [OAuth クライアント シークレット] を入力します。
    5. [追加] をクリックします。

その他

多くの AI アプリケーションには、リモート MCP サーバーに接続する方法があります。通常は、サーバー名、エンドポイント、トランスポート プロトコル、認証方法などのサーバーの詳細を入力する必要があります。Google スプレッドシート リモート MCP サーバーの場合は、次の情報を入力します。

  • サーバー名: sheets

  • サーバーの URL: https://sheetsmcp.googleapis.com/mcp/v1

  • トランスポート: HTTP

  • 認証: Google スプレッドシート リモート MCP サーバー は OAuth 2.0 を使用します。詳細については、 認証と認可についてをご覧ください。

さまざまな種類のクライアントの接続の詳細については、 AI アプリケーションで MCP を構成するをご覧ください。

Google スプレッドシート MCP サーバーをテストする

MCP クライアントを構成したら、テスト プロンプトを実行して接続を確認できます。

MCP クライアントに次の質問をしてみてください。

  • 「Google スプレッドシート abcd123 からシート Sheet1 を読み取ります。」

    クライアントは sheets.get_values を使用してグリッド値を取得します。

  • 「Google スプレッドシート abcd123 の列インデックス 2 に列を挿入します。」

    クライアントは sheets.insert_dimension を実行して列を変更します。

ツールが正常に実行され、関連するレスポンスが返された場合、Google スプレッドシート MCP サーバーは正しく構成されています。

トラブルシューティング

MCP サーバーへの接続で問題が発生した場合は、OAuth ログでエラーを確認できます。管理者に [OAuth ログイベント] [セキュリティ調査ツール]で確認してもらってください。

ツールのリファレンス

Google スプレッドシート MCP サーバーでは次のツールを使用できます。

  • get_values
  • get_spreadsheet
  • update_spreadsheet
  • update_values
  • update_formulas
  • insert_dimension

セキュリティに関する重要な考慮事項: 間接的なプロンプト インジェクション

言語モデルを信頼できないデータに公開すると、間接的なプロンプト インジェクション攻撃のリスクが生じます。 間接的なプロンプト インジェクション攻撃。 Google Antigravity などの MCP クライアントは、Google スプレッドシート MCP サーバーを介して強力なツールと API にアクセスできるため、Google アカウントのデータの読み取り、変更、削除を行うことができます。

このリスクを軽減するには、次のベスト プラクティスに従ってください。

  • 信頼できるツールのみを使用する。Google スプレッドシート MCP サーバーを、信頼できないアプリケーションや未確認のアプリケーションに接続しないでください。
  • 信頼できない入力には注意する。未確認のソースからのスプレッドシートやその他のリソースを処理するように MCP クライアントに依頼しないでください。これらの入力には、セッションをハイジャックして攻撃者がデータを変更、窃取、削除できる隠れた指示が含まれている可能性があります。
  • すべてのアクションを確認する。AI クライアントがユーザーに代わって実行したアクションを常に慎重に確認し、それらが正しく、ユーザーの意図に沿っていることを確認してください。