Gemina FileTag

{
  "document_id": "abc-123",
  "suggested_filename": "2026-02-15_Acme-Corp_Invoice_12345.pdf",
  "metadata": {
    "document_type": "invoice",
    "vendor": "Acme Corp",
    "date": "2026-02-15",
    "amount": 7200,
    "currency": "ILS",
    "document_number": "12345",
    "title": "Invoice",
    "tags": ["vendor", "invoice"]
  },
  "filename_patterns": {
    "date_first": "2026-02-15_Invoice_12345.pdf",
    "type_first": "Invoice_12345_2026-02-15.pdf",
    "vendor_first": "Acme-Corp_Invoice_2026-02-15.pdf",
    "date_vendor": "2026-02-15_Acme-Corp.pdf",
    "vendor_date": "Acme-Corp_2026-02-15.pdf",
    "compact": "Acme-Corp_Invoice.pdf"
  },
  "enriched_file_url": "https://api.gemina.co/files/tmp_abc123.pdf",
  "enriched_file_expires_at": "2026-02-15T12:15:00Z"
}

{
  "status": "success",
  "meta": { "extractionType": "invoice_headers", "modelType": "invictus", "extractionId": "…" },
  "values": {
    "vendorName":   { "value": "Acme Office Supplies Ltd.", "confidence": 0.98 },
    "documentDate": { "value": "2026-02-15" },
    "docNumber":    { "value": "12345" },
    "netAmount":    { "value": 692.31 },
    "vatAmount":    { "value": 117.69 },
    "totalAmount":  { "value": 810.00 },
    "currency":     { "value": "USD" }
  },
  "document": { "documentId": "…", "externalId": "your-idempotency-key" }
}

custom_template を使用すると、values にはテンプレートで定義したフィールドだけが格納されます。

{
  "rows": [
    { "group": { "vendor_name": "Acme Office Supplies Ltd.", "currency": "USD" }, "values": { "sum_total_amount": 810.0, "count": 1 } },
    { "group": { "vendor_name": "BluePeak Cafe",            "currency": "USD" }, "values": { "sum_total_amount": 26.19, "count": 1 } }
  ]
}

• クライアントは MCP URL から RFC 9728（保護されたリソースのメタデータ）および RFC 8414（認可サーバーのメタデータ）を使って認可サーバーを検出します。
  • https://api.gemina.co/.well-known/oauth-protected-resource/api/v1/mcp
  • https://api.gemina.co/.well-known/oauth-authorization-server/api/v1/mcp
• Dynamic Client Registration（DCR）と Client ID Metadata Documents（CIMD）の両方に対応しています。事前登録も、貼り付けるクライアント ID／シークレットも不要です。
• スコープ：mcp。アクセストークンの有効期間は 1 時間です。リフレッシュトークンはローテーションされ、有効期間は 30 日です。
• 接続したアプリごとに、<app> (OAuth) という名前の API キーが作成されます。https://console.gemina.co の Console → API Keys → Connected apps から確認および取り消しができます。
• ほとんどのホストでは URL を指定するだけで使えます。明示的な追加手順が必要なのは Codex CLI、OpenClaw、Hermes-Agent の 3 つです（各セクションを参照）。また、まったくサインインできないものが 3 つあります。Cline（2026-08-27 時点でリモートサーバー向けの OAuth が文書化されていません）、curl、OpenAI Responses API（ブラウザーを使えません）。ChatGPT は逆のケースです。サインインはできますが、API キーを送信できません。

推奨：Connectors 経由の OAuth。 claude.ai と Claude Desktop は同じフローを使用します。設定ファイルも、mcp-remote も、API キーも不要です。承認すると、Gemina がアプリ用のキーを作成します。

URL: https://api.gemina.co/api/v1/mcp/

1. Customize → Connectors
2. Add → Add custom connector
3. Paste the URL
4. Sign in

求められたら Gemina アカウントでサインインし、同意ページで承認してください。Gemina のツールが新しいチャットですぐに表示されます。

代替方法：mcp-remote 経由の API キー。 Claude Desktop の Connectors UI ではカスタムヘッダーを受け付けないため、API キーを使用するには mcp-remote の stdio ブリッジを経由する必要があります。特定のキーが必要な場合（ヘッドレス環境または共有マシン）のみ、この方法を使用してください。

前提条件

1. Node.js 18+ — nodejs.org からインストールします（Windows：「Add to PATH」のチェックを外さないでください。macOS／Linux：標準のインストーラーを使用してください）。

2. Claude Desktop の機能 — Settings → Capabilities を開き、以下を有効にします。

   • コード実行とファイル作成
   • ネットワークへの外部接続を許可
   • ドメインの許可リスト：All domains（または限定的な許可リストに storage.googleapis.com を追加します。署名付きの拡張ファイル URL はここでホストされます）。

   ネットワークへの外部接続が許可されていない場合、tag_file／tag_url は JSON を正しく返しますが、Claude はストレージから拡張ファイル URL を取得できず、「Host not in allowlist」と表示されます。設定は新しいチャットにのみ適用されます。切り替えた後は、新しい会話を開始してください。

設定

Claude Desktop で Settings → Developer → Edit Config を開くと、次の場所にある claude_desktop_config.json が表示されます。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

既存の設定と並べて mcpServers ブロックを追加します。

{
  "mcpServers": {
    "gemina": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.gemina.co/api/v1/mcp/",
        "--header",
        "X-API-Key:${GEMINA_API_KEY}"
      ],
      "env": {
        "GEMINA_API_KEY": "<paste-your-key-here>"
      }
    }
  }
}

保存 → Claude Desktop を完全に終了（Cmd+Q／トレイアイコンを右クリック → Quit）→ 再起動します。初回起動時は、npx が mcp-remote をダウンロードするため、10～30 秒かかる場合があります。

注意事項

• --header 引数の X-API-Key: の後にスペースを入れないでください。これは npx のシェル分割パーサーに対する、ドキュメントに記載された回避策です。
• 環境変数による間接参照（${GEMINA_API_KEY}）を使うことで、プロセス一覧から漏れる可能性のある args にキーの値を直接記述せずに済みます。
• Windows で spawn npx ENOENT が発生する場合：Claude Desktop はシェルの PATH を引き継ぎません。PowerShell で where npx を実行して取得した絶対パスに "command": "npx" を置き換えてください（JSON ではスラッシュを使用できます）。例："C:/Program Files/nodejs/npx.cmd"。

OAuth（デフォルト）： サーバーを登録してから /mcp を実行してサインインします。Claude Code がブラウザーで Gemina のサインインページを開きます。

claude mcp add --transport http gemina https://api.gemina.co/api/v1/mcp/
# then run /mcp and sign in

Claude Code 内で、/mcp → gemina を選択 → Authenticate → ブラウザーで Gemina アカウントにサインイン → 同意ページで承認します。

API キー（ヘッドレス）：

claude mcp add --transport http gemina https://api.gemina.co/api/v1/mcp/ \
  --header "X-API-Key: <paste-your-key-here>"

ファイル：~/.cursor/mcp.json（すべてのプロジェクト）または .cursor/mcp.json（1 つのプロジェクト）。Cursor は動的に自身を登録し、最初の 401 でブラウザーを開きます。ファイルにクライアント ID やシークレットを記述する必要はありません。

OAuth（デフォルト）：

{
  "mcpServers": {
    "gemina": {
      "url": "https://api.gemina.co/api/v1/mcp/"
    }
  }
}

API キー（ヘッドレス）：

{
  "mcpServers": {
    "gemina": {
      "url": "https://api.gemina.co/api/v1/mcp/",
      "headers": {
        "X-API-Key": "<paste-your-key-here>"
      }
    }
  }
}

ファイル：.vscode/mcp.json（ワークスペースごと）。または、すべてのワークスペースで使うには、コマンドパレットから MCP: Open User Configuration を実行します。VS Code は動的に登録され、最初の接続時にブラウザーを開きます。信頼確認のプロンプトで承認してから、Accounts → Manage Trusted MCP Servers でアカウントを確認してください。

OAuth（デフォルト）：

{
  "servers": {
    "gemina": {
      "type": "http",
      "url": "https://api.gemina.co/api/v1/mcp/"
    }
  }
}

API キー（ヘッドレス）：

{
  "servers": {
    "gemina": {
      "type": "http",
      "url": "https://api.gemina.co/api/v1/mcp/",
      "headers": {
        "X-API-Key": "<paste-your-key-here>"
      }
    }
  }
}

Cline の MCP 設定（歯車アイコン → MCP Servers → Edit Config）に、次を追加します。

OAuth（デフォルト）：

Cline は API キーのみ対応しています。 2026-08-27 時点で、Cline にはリモート MCP サーバー向けの OAuth の手順がドキュメントに記載されていません。 Cline の MCP ドキュメントには OAuth への言及がなく、OAuth に言及している唯一のリリースノート（v4.1.7）も、streamableHttp ではなく従来の SSE トランスポートについて説明しています。 以下の API キー形式を使用してください。

API キー（ヘッドレス）：

{
  "mcpServers": {
    "gemina": {
      "type": "streamableHttp",
      "url": "https://api.gemina.co/api/v1/mcp/",
      "headers": {
        "X-API-Key": "<paste-your-key-here>"
      }
    }
  }
}

ファイル：~/.codeium/windsurf/mcp_config.json、または Cascade パネルの MCP アイコン。リモートサーバーには serverUrl を指定します（url も使用できます）。その後、MCP リストを再読み込みしてください。現在は Devin Desktop として提供されており、Windsurf のドキュメントはそちらにリダイレクトされます。

ドキュメントには Cascade が「各トランスポートタイプの OAuth に対応」とありますが、明示的なサインイン手順は説明されていません。ブラウザーのプロンプトが表示されない場合は、API キー形式を使用してください。

OAuth（デフォルト）：

{
  "mcpServers": {
    "gemina": {
      "serverUrl": "https://api.gemina.co/api/v1/mcp/"
    }
  }
}

API キー（ヘッドレス）：

{
  "mcpServers": {
    "gemina": {
      "serverUrl": "https://api.gemina.co/api/v1/mcp/",
      "headers": {
        "X-API-Key": "<paste-your-key-here>"
      }
    }
  }
}

OAuth（デフォルト）：

codex mcp add gemina --url https://api.gemina.co/api/v1/mcp/
codex mcp login gemina

codex mcp add は URL から OAuth を検出し、通常はブラウザーでのサインインを自動的に開始します。確実に開始するには、ドキュメントに記載されている codex mcp login を使用してください。OAuth の場合、[mcp_servers.gemina] のみのブロックをそのまま貼り付けないでください。Codex はサーバーに 未認証 で接続するため、すべてのツール呼び出しが失敗します。2026-08-27 に codex-cli 0.150.1 で確認済みです。

API キーを使う場合は、~/.codex/config.toml に追記してください。

API キー（ヘッドレス）：

[mcp_servers.gemina]
url = "https://api.gemina.co/api/v1/mcp/"
http_headers = { "X-API-Key" = "<paste-your-key-here>" }

OAuth（デフォルト）：

openclaw mcp set gemina '{"url":"https://api.gemina.co/api/v1/mcp/","transport":"streamable-http","auth":"oauth"}'
openclaw mcp login gemina

両方の行が必要です。mcp set は auth: "oauth" を指定してサーバーを保存します。mcp login は認証フローを実行します。OpenClaw は 401 を受けても、自動で OAuth を開始することはありません。ヘッドレス環境では、openclaw mcp login gemina --code <code> でコードを渡し、openclaw mcp doctor gemina --probe で確認してください。

API キー（ヘッドレス）：

openclaw mcp set gemina '{"url":"https://api.gemina.co/api/v1/mcp/","transport":"streamable-http","headers":{"X-API-Key":"<paste-your-key-here>"}}'

~/.hermes/config.yaml の mcp_servers の下に追記してください。

OAuth（デフォルト）：

mcp_servers:
  gemina:
    url: "https://api.gemina.co/api/v1/mcp/"
    auth: oauth

その後、稼働中のセッション内ではなく、新しいターミナルから hermes mcp login gemina を実行してください。セッション内での設定再読み込みは 30 秒でタイムアウトするため、ブラウザーでのサインインには短すぎます。auth: oauth の行を指定することで OAuth が有効になります。Hermes は 401 から OAuth を推測して開始することはありません。

API キー（ヘッドレス）：

mcp_servers:
  gemina:
    url: "https://api.gemina.co/api/v1/mcp/"
    headers:
      X-API-Key: "<paste-your-key-here>"

xAI のコーディングエージェントです。curl -fsSL https://x.ai/cli/install.sh | bash でインストールします。初回使用時に OAuth によってブラウザーでの認証フローが開始され、トークンは ~/.grok/mcp_credentials.json にキャッシュされます。grok.com で設定する場合は、Connectors → New Connector → Custom を選択し、URL を貼り付けます。

OAuth（デフォルト）：

grok mcp add --transport http gemina https://api.gemina.co/api/v1/mcp/

API キー（ヘッドレス）：

grok mcp add --transport http gemina https://api.gemina.co/api/v1/mcp/ \
  --header "X-API-Key: <paste-your-key-here>"

Google のターミナルエージェントです。-s user を追加すると、すべてのプロジェクトで Gemina をインストールできます。OAuth の設定は不要です。デフォルトの dynamic_discovery プロバイダーが 401 を受けて自動的に登録され、ブラウザーが開きます。トークンは ~/.gemini/mcp-oauth-tokens.json にキャッシュされます。/mcp auth gemina で再度サインインします。

OAuth（デフォルト）：

gemini mcp add --transport http gemina https://api.gemina.co/api/v1/mcp/

API キー（ヘッドレス）：

gemini mcp add --transport http \
  --header "X-API-Key: <paste-your-key-here>" \
  gemina https://api.gemina.co/api/v1/mcp/

クラウドまたはセルフホスト可能なワークフロー自動化ツールです。AI Agent の下にある MCP Client Tool ノード、または通常のワークフローステップには MCP Client を使用します。OAuth を使用する場合は、MCP OAuth2 API 認証情報を作成し、Dynamic Client Registration を有効にしたまま、Resource URL を空欄にします。n8n が Gemina に登録されます。MCP Client Tool ノード v1.2 以降が必要です。

OAuth（デフォルト）：

URL: https://api.gemina.co/api/v1/mcp/

1. Add the MCP Client Tool node (under an AI Agent), or MCP Client for a plain step
2. MCP Endpoint URL: paste the URL above
3. Server Transport: HTTP Streamable
4. Authentication: MCP OAuth2
5. Credentials -> create an "MCP OAuth2 API" credential; leave Dynamic Client
   Registration on and Resource URL empty
6. Click sign in, approve Gemina in the browser, then set Tools to Include

API キー（ヘッドレス）：

URL: https://api.gemina.co/api/v1/mcp/

1. Add the MCP Client Tool node (under an AI Agent), or MCP Client for a plain step
2. MCP Endpoint URL: paste the URL above
3. Server Transport: HTTP Streamable
4. Authentication: Header Auth -> Name: X-API-Key, Value: <paste-your-key-here>
5. Set Tools to Include (All, or a subset)

Microsoft のエージェントビルダーです。ブラウザーのウィザードを使用するため、設定ファイルは不要です。Dynamic discovery が適切な方法です。Gemina は DCR とディスカバリー用ドキュメントを公開するため、クライアント ID、シークレット、エンドポイント URL を入力する必要はありません。Copilot Studio がサポートするのは Streamable トランスポートのみです。MCP へのアクセスは Power Platform コネクタ経由となるため、テナントの DLP ポリシーが適用されます。

OAuth（デフォルト）：

URL: https://api.gemina.co/api/v1/mcp/

1. In your agent: Tools -> Add a tool -> New tool -> Model Context Protocol
2. Server name: Gemina
3. Server URL: paste the URL above
4. Authentication: OAuth 2.0 -> Type: Dynamic discovery
5. Create -> Create a new connection -> Add to agent

API キー（ヘッドレス）：

URL: https://api.gemina.co/api/v1/mcp/

1. In your agent: Tools -> Add a tool -> New tool -> Model Context Protocol
2. Server name: Gemina
3. Server URL: paste the URL above
4. Authentication: API key -> Type: Header -> Name: X-API-Key
5. Create -> Create a new connection (paste <paste-your-key-here>) -> Add to agent

MCP Client アプリ（ベータ版）を通じて、Gemina のツールを 8,000 以上のアプリに接続します。設定ファイルではなく、接続フォームを使用します。

Bearer のみです。 Zapier にはカスタムヘッダーフィールドがないため、キーは Bearer Token ボックスに入力します。Gemina はこれを Authorization: Bearer として受け付けます。ここでは X-API-Key を使う方法はありません。

OAuth（デフォルト）：

URL: https://api.gemina.co/api/v1/mcp/

1. Apps -> + Add connection -> MCP Client -> Add connection
2. Server URL: paste the URL above
3. Transport: Streamable HTTP
4. OAuth: Yes (leave Bearer Token blank)
5. Continue, then sign in to Gemina in the tab that opens

API キー（ヘッドレス）：

URL: https://api.gemina.co/api/v1/mcp/

1. Apps -> + Add connection -> MCP Client -> Add connection
2. Server URL: paste the URL above
3. Transport: Streamable HTTP
4. OAuth: No
5. Bearer Token: <paste-your-key-here>

Web 版 ChatGPT で、Gemina をカスタム MCP アプリとして追加します。Developer mode と、Pro、Plus、Business、Enterprise、Edu のいずれかのアカウントが必要です。

OAuth のみです。 ChatGPT はカスタムヘッダーや API キーをリモート MCP サーバーに送信できないため、ここではヘッドレスでの接続方法はありません。代わりにサインインするか、特定のキーが必要な場合は Codex CLI を使用してください。

セットアップ手順：

URL: https://api.gemina.co/api/v1/mcp/

1. Settings -> Security and login -> turn on Developer mode
2. Go to chatgpt.com/plugins and select +
3. Name it "Gemina" and paste the URL above under Connection
4. Create, then sign in to Gemina when ChatGPT prompts

独自の製品に Gemina を組み込む場合に使用します。ツールエントリーを 1 つ追加するだけで、Gemina の機能全体を OpenAI 側の機能として利用できます。

API キーのみです。 これはブラウザーを使わないサーバーサイドの接続方法のため、OAuth でサインインする必要はありません。すでに保持している認証情報を API が転送します。

API キー：

curl https://api.openai.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -d '{
    "model": "gpt-5.6",
    "input": "Extract the totals from the invoice I uploaded.",
    "tools": [{
      "type": "mcp",
      "server_label": "gemina",
      "server_url": "https://api.gemina.co/api/v1/mcp/",
      "headers": { "X-API-Key": "<paste-your-key-here>" },
      "require_approval": "never"
    }]
  }'