Gemina

co.gemina由 gemina.co 發布官方發布者v2.1.0更新於 Oct 24, 2026

Extract, search and tag any document: invoices, receipts, contracts, templates. OAuth or API key.

已驗證Streamable HTTP可網頁執行檔案與儲存知識與記憶資料與分析

服務詳細資訊

識別碼: co.gemina/gemina
傳輸: Streamable HTTP
執行環境: Web executable
信任: Verified
發布於: Sep 16, 2026

安全提示

MCP 服務會接收對話中的工具呼叫請求，並可能執行外部操作。啟用前請先了解該服務能做什麼，並只授予它所需的權限。

註冊中心已驗證此服務的命名空間屬於 gemina.co，且該網域同時執行其端點。這可以確認發布者，但並不代表該服務的工具是安全的。

SourceWeft 的檢查只涵蓋條目是否完整、端點是否回應；不審查伺服器的程式碼，也不審查其工具的行為。

在 README 中新增徽章

向讀者展示該 MCP 服務已收錄於 SourceWeft，徽章連結到本頁。

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/co.gemina%2Fgemina.svg)](https://sourceweft.com/mcp/co.gemina%2Fgemina?utm_source=readme&utm_medium=badge)

概覽

AI 產生的概覽

Gemina 是託管式 MCP 伺服器，讓助理為發票、收據、合約等 PDF 與圖片加上標籤、擷取欄位，並進行搜尋與彙總統計。

可以做什麼: 上傳文件並加上標籤：取得結構化中繼資料、六個建議檔名，以及內嵌中繼資料的副本；也可由伺服器端抓取公開網址直接標記，檔案內容不經過模型上下文。擷取欄位：使用現成的發票抬頭與明細項目模型、純 OCR 或自訂範本，並可輪詢結果、列出歷來擷取、依 ID 取得文件及其全部擷取、對已存放文件追加擷取類型，以及回傳修正值作為回饋。檢索與彙總已索引檔案：結構化、語意或混合查詢，依供應商、幣別、類型或月份分組加總、平均與計數。對修正後的文件重新建立索引或補建索引。
適用情境: 適合發票與收據建檔、批次整理與重新命名文件資料夾、分揀郵件附件，以及在不重新上傳的情況下對既有文件檔案提問或統計支出。也適合在 RAG 入庫前為文件補上供應商、日期與類型中繼資料。
執行需求: 遠端 Streamable HTTP 端點，本機不需執行任何程式。需要 Gemina 帳號並以 OAuth 2.1 登入，無介面用戶端則使用 X-API-Key 標頭。需能連線該端點以及提供增強檔案連結的儲存主機。部分用戶端需要額外步驟或無法登入；免費額度為每月 1,500 次 FileTag 標籤。

安裝前請注意

文件會上傳到 Gemina 的伺服器，傳送敏感檔案前請考量資料駐留與保留政策；預設在上傳後 7 天內刪除。擷取與文件智慧工具需要付費方案，並依擷取次數計費。X-API-Key 屬於機密，避免放在可能被行程清單看到的命令列參數中。加上標籤與擷取會將資料寫入帳號，並把文件加入索引供後續檢索。

安裝

在 SourceWeft 中

開啟儀表板中的 Gemina，將其新增到工作區。
連接所需的憑證。它們會被私密儲存，絕不會在公開頁面上展示。
為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/co.gemina%2Fgemina/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。客戶端會在首次連接時完成 OAuth 登入。

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

README

[Gemina]

Gemina — MCP server

Tag, extract, and search your documents from any MCP client. Free tier: 1,500 FileTag tags/month, no credit card.

[License: MIT] [Free tier] [MCP] [Last commit]

Install • Examples • Product page • Full docs

What is this?

This repository is the discovery, install, and examples surface for Gemina's MCP server. The server itself is hosted at https://api.gemina.co/api/v1/mcp/ — there is no daemon to run locally. Point your MCP-compatible client at the endpoint, sign in with your Gemina account (or paste an API key for headless use), and tag your first document in under a minute.

One server, three tool groups: FileTag (free tier — tag, rename, and enrich any PDF or image), Extraction (Core-OCR: invoice headers, line items, full text, custom templates), and Document Intelligence (ask questions and run spend analytics over your indexed documents — no re-upload). See Tools for the full list.

The server itself is closed-source (operated by Gemina). Everything in this repo — install snippets, examples, integration code — is MIT-licensed and contributions are welcome.

What you get

One sign-in, three tool groups. Every group takes any PDF or image up to 50 MB (PDF, PNG, JPEG, GIF, WebP, HEIC/HEIF, AVIF).

1. FileTag — tag, rename, enrich (free tier). Send a document, get structured metadata, six suggested filenames, and a downloadable copy with the metadata embedded in the file itself. Tools: files_create_upload → tag_file, or tag_url.

2. Extraction — pull the fields out (paid). Ready-made models for invoice headers and invoice line items (plus Hebrew document details and line items); and custom templates — you define the fields, Gemina extracts them from any document type: contracts, forms, statements, delivery notes, IDs, anything. Tools: files_create_upload (purpose='extract') → extract_document → get_extraction_result, list_extractions, get_extraction, get_document, add_document_extractions (run more extraction types on a stored document — no re-upload; wait for the values, or wait=false and just file it for later search), submit_extraction_feedback (send corrections back).

3. Document Intelligence — ask your archive (paid). Ask questions and run spend analytics across your whole indexed collection — no re-upload. Every document you tag (FileTag) or run a structured extraction on is submitted for indexing when indexing is enabled — plain OCR isn't, and a document can be skipped (no extractable fields, or no indexing credits). Search by vendor, date, amount, type or free text (query_documents); get sums, averages and counts grouped by vendor, currency, type or month (aggregate_documents) — e.g. “total spent per vendor last quarter”. Tools: query_documents, aggregate_documents, index_document.

Sample: FileTag output (click to expand)

json

{  "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"}

{  "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"}

Sample: extraction output (abridged — extract_document with invoice_headers)

json

{  "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" }}

{  "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" }}

With custom_template, values contains exactly the fields you defined in the template.

Sample: Document Intelligence (abridged — aggregate_documents)

json

{  "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 } }  ]}

{  "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 } }  ]}

Quick install

Sign in with your Gemina account — no API key to copy. Every snippet below points your client at the endpoint; the client discovers Gemina's authorization server and opens a browser sign-in. Don't have an account? Create one free (no credit card) at https://console.gemina.co/registration/create-account.

Running headless (CI, servers, scripts, or a client that doesn't prompt to sign in)? Use the API-key form shown under each client instead.

Endpoint: https://api.gemina.co/api/v1/mcp/ · Transport: Streamable HTTP · Auth: OAuth 2.1 sign-in (default) or X-API-Key header (headless)

How OAuth sign-in works (click to expand)

Clients discover the authorization server from the MCP URL via RFC 9728 (protected-resource metadata) and RFC 8414 (authorization-server metadata):
- 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) and Client ID Metadata Documents (CIMD) are both supported — no pre-registration, no client ID/secret to paste.
Scope: mcp. Access tokens last 1 hour; refresh tokens rotate and last 30 days.
Each connected app gets its own API key named <app> (OAuth). See and revoke them under Console → API Keys → Connected apps at https://console.gemina.co.
Most hosts need nothing beyond the URL. Three need an explicit second step — Codex CLI, OpenClaw and Hermes-Agent (see their sections) — and three can't sign in at all: Cline (no documented OAuth for remote servers as of 2026-08-27), curl and the OpenAI Responses API (no browser). ChatGPT is the mirror case: it signs in, but cannot send an API key.

Claude Desktop / claude.ai

Recommended: OAuth via Connectors. claude.ai and Claude Desktop use the same flow — no config file, no mcp-remote, no API key. Gemina creates a key for the app when you approve it.

text

URL: https://api.gemina.co/api/v1/mcp/
1. Customize → Connectors2. Add → Add custom connector3. Paste the URL4. Sign in

URL: https://api.gemina.co/api/v1/mcp/
1. Customize → Connectors2. Add → Add custom connector3. Paste the URL4. Sign in

Sign in with your Gemina account when prompted and approve the consent page. The Gemina tools appear in new chats immediately.

Fallback: API key via mcp-remote. Claude Desktop's Connectors UI doesn't accept custom headers, so an API key has to go through the mcp-remote stdio bridge. Use this only if you need a specific key (headless or shared machines).

Prerequisites

Node.js 18+ — install from nodejs.org (Windows: ensure "Add to PATH" stays checked; macOS/Linux: standard installer).
Claude Desktop capabilities — open Settings → Capabilities and turn on:
- Code execution and file creation
- Allow network egress
- Domain allowlist: All domains (or add storage.googleapis.com to the narrow allowlist — that's where signed enriched-file URLs are hosted).
Without network egress, tag_file/tag_url return JSON correctly but Claude can't fetch the enriched-file URL from storage and you'll see "Host not in allowlist". Settings only apply to new chats — start a fresh conversation after toggling.

Config

In Claude Desktop, Settings → Developer → Edit Config opens claude_desktop_config.json at:

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

Merge the mcpServers block alongside any existing config:

json

{  "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>"      }    }  }}

{  "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>"      }    }  }}

Save → fully quit Claude Desktop (Cmd+Q / right-click tray → Quit) → relaunch. First launch may take 10–30s while npx downloads mcp-remote.

Notes

No space after X-API-Key: in the --header arg — it's the documented workaround for npx's shell-split parsing.
The env-var indirection (${GEMINA_API_KEY}) keeps the literal key out of args, where it could leak via process listings.
Windows + spawn npx ENOENT: Claude Desktop doesn't inherit your shell's PATH. Replace "command": "npx" with the absolute path from where npx in PowerShell (forward slashes work in JSON), e.g. "C:/Program Files/nodejs/npx.cmd".

Claude Code (CLI)

OAuth (default): register the server, then run /mcp and sign in — Claude Code opens the Gemina sign-in in your browser.

bash

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

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

Inside Claude Code: /mcp → select gemina → Authenticate → sign in with your Gemina account in the browser → approve the consent page.

API key (headless):

bash

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

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

Cursor

File: ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project). Cursor registers itself dynamically and opens your browser on the first 401 — no client ID or secret in the file.

OAuth (default):

API key (headless):

json

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

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

VS Code

File: .vscode/mcp.json (per workspace), or run MCP: Open User Configuration from the Command Palette for all of them. VS Code registers dynamically and opens a browser on first connection; confirm the trust prompt, then find the account under Accounts → Manage Trusted MCP Servers.

OAuth (default):

json

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

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

API key (headless):

json

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

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

Cline

In Cline's MCP settings (gear icon → MCP Servers → Edit Config), add:

OAuth (default):

Cline is API-key only. As of 2026-08-27 Cline has no documented OAuth path for remote MCP servers — its MCP docs never mention OAuth, and the one release note that does (v4.1.7) names the legacy SSE transport, not streamableHttp. Use the API-key form below.

API key (headless):

json

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

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

Windsurf

File: ~/.codeium/windsurf/mcp_config.json, or the MCPs icon in the Cascade panel. Remote servers take serverUrl (url also works), then reload the MCP list. Now shipped as Devin Desktop — the Windsurf docs redirect there.

The docs say Cascade "supports OAuth for each transport type" but describe no explicit sign-in step, so if no browser prompt appears, use the API-key form.

OAuth (default):

API key (headless):

json

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

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

Codex CLI

OAuth (default):

codex mcp add detects OAuth on the URL and usually starts the browser sign-in by itself; codex mcp login is the documented guarantee. Do not paste a bare [mcp_servers.gemina] block for OAuth — Codex will connect to the server unauthenticated and every tool call fails. Verified against codex-cli 0.150.1 on 2026-08-27.

For the API-key lane, append to ~/.codex/config.toml:

API key (headless):

toml

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

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

OpenClaw

OAuth (default):

bash

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

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

Both lines are required. mcp set stores the server with auth: "oauth"; mcp login runs the flow — OpenClaw does not start OAuth off a 401 on its own. On a headless box, pass the code back with openclaw mcp login gemina --code <code>, and check it with openclaw mcp doctor gemina --probe.

API key (headless):

bash

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

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

Hermes-Agent

Append under mcp_servers in ~/.hermes/config.yaml:

OAuth (default):

Then run hermes mcp login gemina from a fresh terminal, not inside a live session — the in-session config reload times out at 30s, too short for a browser sign-in. The auth: oauth line is what turns OAuth on; Hermes never infers it from a 401.

API key (headless):

yaml

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

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

Grok

xAI's coding agent. Install with curl -fsSL https://x.ai/cli/install.sh | bash. OAuth triggers a browser flow on first use; tokens cache in ~/.grok/mcp_credentials.json. On grok.com instead: Connectors → New Connector → Custom, paste the URL.

OAuth (default):

API key (headless):

bash

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

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

Gemini CLI

Google's terminal agent. Add -s user to install Gemina for every project. Nothing to configure for OAuth — the default dynamic_discovery provider registers itself off the 401 and opens your browser; tokens cache in ~/.gemini/mcp-oauth-tokens.json. Re-run the sign-in with /mcp auth gemina.

OAuth (default):

API key (headless):

bash

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

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

n8n

Workflow automation, cloud or self-hosted. Use the MCP Client Tool node under an AI Agent, or MCP Client for a plain workflow step. For OAuth, create an MCP OAuth2 API credential and leave Dynamic Client Registration on with Resource URL empty — n8n registers itself with Gemina. Needs MCP Client Tool node v1.2 or later.

OAuth (default):

text

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 step2. MCP Endpoint URL: paste the URL above3. Server Transport: HTTP Streamable4. Authentication: MCP OAuth25. Credentials -> create an "MCP OAuth2 API" credential; leave Dynamic Client   Registration on and Resource URL empty6. Click sign in, approve Gemina in the browser, then set Tools to Include

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 step2. MCP Endpoint URL: paste the URL above3. Server Transport: HTTP Streamable4. Authentication: MCP OAuth25. Credentials -> create an "MCP OAuth2 API" credential; leave Dynamic Client   Registration on and Resource URL empty6. Click sign in, approve Gemina in the browser, then set Tools to Include

API key (headless):

text

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 step2. MCP Endpoint URL: paste the URL above3. Server Transport: HTTP Streamable4. Authentication: Header Auth -> Name: X-API-Key, Value: <paste-your-key-here>5. Set Tools to Include (All, or a subset)

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 step2. MCP Endpoint URL: paste the URL above3. Server Transport: HTTP Streamable4. Authentication: Header Auth -> Name: X-API-Key, Value: <paste-your-key-here>5. Set Tools to Include (All, or a subset)

Copilot Studio

Microsoft's agent builder — a browser wizard, no config file. Dynamic discovery is the right lane: Gemina publishes DCR and the discovery documents, so no client ID, secret or endpoint URL has to be typed. Copilot Studio supports the Streamable transport only. MCP access flows through Power Platform connectors, so tenant DLP policies apply.

OAuth (default):

text

URL: https://api.gemina.co/api/v1/mcp/
1. In your agent: Tools -> Add a tool -> New tool -> Model Context Protocol2. Server name: Gemina3. Server URL: paste the URL above4. Authentication: OAuth 2.0 -> Type: Dynamic discovery5. Create -> Create a new connection -> Add to agent

URL: https://api.gemina.co/api/v1/mcp/
1. In your agent: Tools -> Add a tool -> New tool -> Model Context Protocol2. Server name: Gemina3. Server URL: paste the URL above4. Authentication: OAuth 2.0 -> Type: Dynamic discovery5. Create -> Create a new connection -> Add to agent

API key (headless):

text

URL: https://api.gemina.co/api/v1/mcp/
1. In your agent: Tools -> Add a tool -> New tool -> Model Context Protocol2. Server name: Gemina3. Server URL: paste the URL above4. Authentication: API key -> Type: Header -> Name: X-API-Key5. Create -> Create a new connection (paste <paste-your-key-here>) -> Add to agent

URL: https://api.gemina.co/api/v1/mcp/
1. In your agent: Tools -> Add a tool -> New tool -> Model Context Protocol2. Server name: Gemina3. Server URL: paste the URL above4. Authentication: API key -> Type: Header -> Name: X-API-Key5. Create -> Create a new connection (paste <paste-your-key-here>) -> Add to agent

Zapier

Connects Gemina's tools to 8,000+ apps through the MCP Client app (Beta). A connection form, not a config file.

Bearer only. Zapier has no custom-header field, so the key goes in the Bearer Token box — Gemina accepts it as Authorization: Bearer. There is no X-API-Key lane here.

OAuth (default):

text

URL: https://api.gemina.co/api/v1/mcp/
1. Apps -> + Add connection -> MCP Client -> Add connection2. Server URL: paste the URL above3. Transport: Streamable HTTP4. OAuth: Yes (leave Bearer Token blank)5. Continue, then sign in to Gemina in the tab that opens

URL: https://api.gemina.co/api/v1/mcp/
1. Apps -> + Add connection -> MCP Client -> Add connection2. Server URL: paste the URL above3. Transport: Streamable HTTP4. OAuth: Yes (leave Bearer Token blank)5. Continue, then sign in to Gemina in the tab that opens

API key (headless):

text

URL: https://api.gemina.co/api/v1/mcp/
1. Apps -> + Add connection -> MCP Client -> Add connection2. Server URL: paste the URL above3. Transport: Streamable HTTP4. OAuth: No5. Bearer Token: <paste-your-key-here>

URL: https://api.gemina.co/api/v1/mcp/
1. Apps -> + Add connection -> MCP Client -> Add connection2. Server URL: paste the URL above3. Transport: Streamable HTTP4. OAuth: No5. Bearer Token: <paste-your-key-here>

ChatGPT

Add Gemina as a custom MCP app in ChatGPT on the web. Needs Developer mode and a Pro, Plus, Business, Enterprise or Edu account.

OAuth only. ChatGPT cannot send a custom header or an API key to a remote MCP server, so there is no headless lane here — sign in instead, or use Codex CLI if you need a specific key.

Setup steps:

text

URL: https://api.gemina.co/api/v1/mcp/
1. Settings -> Security and login -> turn on Developer mode2. Go to chatgpt.com/plugins and select +3. Name it "Gemina" and paste the URL above under Connection4. Create, then sign in to Gemina when ChatGPT prompts

URL: https://api.gemina.co/api/v1/mcp/
1. Settings -> Security and login -> turn on Developer mode2. Go to chatgpt.com/plugins and select +3. Name it "Gemina" and paste the URL above under Connection4. Create, then sign in to Gemina when ChatGPT prompts

OpenAI Responses API

For embedding Gemina in your own product: one tool entry turns the whole Gemina surface into an OpenAI-side capability.

API key only. This is a server-side lane with no browser, so there is no OAuth sign-in to run — the API forwards a credential you already hold.

API key:

bash

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"    }]  }'

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"    }]  }'

For the full machine-readable install guide (used by agents), see llms-install.md.

Free tier

Free tier: 1,500 FileTag tags per month. No credit card required. Sign up at gemina.co/filetag, then sign in from your MCP client — or grab an API key for headless use. The same key works for both MCP and the REST API.

Need more? Paid plans add larger monthly allowances, the extraction and document-intelligence tools, configurable data residency, and longer retention. See pricing.

Tools

One endpoint, 13 tools in three groups, plus 2 prompts. Every tool is listed for every key; the extraction and document-intelligence groups require a paid plan (see pricing). Anonymous discovery (tools/list, prompts/list) is available at https://api.gemina.co/api/v1/mcp/public/.

FileTag (free tier)

Tool	What it does
`files_create_upload`	Reserve a pre-signed PUT slot. Returns `file_id`, the upload URL, the headers to echo on the PUT, and a `next_tool_call` recipe — `tag_file` by default, `extract_document` with `purpose='extract'`. One slot type: any slot works with either tool.
`tag_file`	Run the FileTag pipeline on an uploaded slot: metadata, six filename patterns, and a short-lived enriched-file URL.
`tag_url`	Fetch a public HTTPS URL server-side and tag it — the bytes never pass through the model context.

Extraction (Core-OCR)

Tool	What it does
`extract_document`	Run one or more extraction types on an uploaded slot (from `files_create_upload`): `invoice_headers`, `invoice_line_items`, `custom_template`, `ocr` (plain text; runs only on the `praetorian` model), plus the legacy `document_details_hebrew` / `document_line_items_hebrew` (praetorian-only, not recommended for new work). Model choice is a recommendation, not a rule: `velox` for headers, `invictus` with thinking for line items.
`get_extraction_result`	Poll an asynchronous extraction by `meta.correlationId`.
`list_extractions`	List past extractions, newest first, with filters and pagination.
`get_extraction`	Fetch one extraction by id, including the full extracted data.
`get_document`	Fetch one document by id, including all of its extractions.
`add_document_extractions`	Run more extraction types on a document Gemina already stores (by id) — no re-upload; paid per extraction. Two modes: wait for the values (default), or `wait=false` to file the document for later search and return at once.
`submit_extraction_feedback`	Send verified/corrected field values back — the extraction-quality feedback loop.

Document Intelligence

Tool	What it does
`query_documents`	Search your indexed documents: `structured` filters, `semantic` similarity, or `hybrid` (best default).
`aggregate_documents`	Sums/averages/min/max/counts over indexed documents, grouped by vendor, currency, type, month, and more.
`index_document`	(Re)index one document into the searchable index — after corrections or to backfill.

Prompts: explain_filename_patterns (the six filename patterns and when to use each) · explain_upload_flow (files_create_upload → PUT → tag_file).

The full reference for each group is in llms-install.md.

Use cases

Use case	Tools	Example
🧾 Invoice / receipt data entry	`extract_document` (`invoice_headers`, `invoice_line_items`) → your accounting, ERP or spreadsheet	`examples/bulk-tag-folder`
📄 Any document, your fields	`extract_document` with a `custom_template` (contracts, forms, statements, delivery notes, IDs)	— define the template in the console
📊 Questions over your archive	`query_documents`, `aggregate_documents` ("total spend with vendor X in Q2")	—
📥 Email attachment triage	FileTag: tag inbound attachments, route to folders by vendor/type	`examples/gmail-attachment-triage`
🔍 RAG ingestion	FileTag metadata on vector-store entries so retrieval can filter by vendor, date, type	`examples/llamaindex-reader` · `examples/langchain-loader`
📁 Bulk document filing	FileTag: walk a directory, rename every file to a consistent pattern	`examples/bulk-tag-folder`
⚡ Quickstart (curl)	First tag in three minutes, no MCP client needed	`examples/curl-quickstart`
🖥️ Claude Desktop walkthrough	Step-by-step setup with screenshots	`examples/claude-desktop`

Why Gemina, not a raw LLM call?

A naive "ask the model to read this PDF" pipeline breaks in production: hallucinated vendor names, inconsistent dates, no stable schema, no line-item arithmetic, no feedback loop, nothing to search afterwards.

	Raw LLM	Gemina
Structured output	Free text, requires parsing	Stable JSON schema per extraction type, or your own template fields
Line items	Rows guessed from text	Column-aware line-item extraction with totals reconciliation
Hallucinations	Frequent	Cross-checked, refuses when unsure; corrections fed back with `submit_extraction_feedback`
Search & totals	Build your own index	Every extraction indexed; `query_documents` / `aggregate_documents`
Filing	DIY	Six filename patterns + metadata-embedded copy (FileTag)
Data residency	Wherever the model runs	You pick the region per account: EU, US, Israel or Asia
Cost	$$ per call	Free tier: first 1,500 FileTag tags/month

Privacy & trust

No model training. Your documents are never used to train AI models — Gemina's or anyone else's.
7-day deletion. Files are deleted within 7 days of upload (configurable per plan).
Encryption. AES-256 at rest, TLS 1.3 in transit.
Compliance. GDPR and CCPA compliant. Configurable data residency on paid plans.

Full details on the Gemina Trust Center.

Documentation

📖 Full docs: gemina.co/docs/mcp — REST + MCP reference
🤖 Agent install guide: llms-install.md — machine-readable, used by AI agents auto-discovering the server
🔌 MCP manifest: gemina.co/.well-known/mcp.json
🏷️ REST endpoint reference: gemina.co/docs.md

Community & support

🐛 Bug reports
🆘 Integration help
💬 Discussions
✉️ Email: [email protected]
🔒 Security: see SECURITY.md

For aggregators and directory listings

The Dockerfile at the repo root is not for end users. It exists so directory operators (e.g. Glama's /mcp/servers/ tier) can build a container that introspects the public tool surface without provisioning credentials. The container runs mcp-remote against https://api.gemina.co/api/v1/mcp/public/ — a read-only discovery endpoint that serves initialize / tools/list / prompts/list to anonymous callers but refuses tools/call. End users should follow the Quick install section above and connect to the authenticated endpoint by signing in (or with their personal API key).

Contributing

Examples PRs welcome — see CONTRIBUTING.md. The server itself is closed-source, so PRs that touch the actual MCP server logic will be declined, but bug reports against the live server are very welcome.

License

The contents of this repository — install snippets, example code, documentation, configuration files, and sample assets — are released under the MIT License.

The Gemina MCP server itself is a hosted closed-source service operated by Gemina (https://gemina.co) and is not covered by this license. Use of the server is governed by Gemina's Terms of Service and Privacy Policy.

來源：README.md，提交 f47ecef

工具

該伺服器需要登入，因此 SourceWeft 無法在沒有帳號的情況下讀取其工具，也未收錄。已連接帳號所能看到的內容可能因帳號及其權限而異。

版本歷史

v2.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 85%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

近 30 天內可連通必需25 分
已宣告認證方式必需10 分
已列出工具15 分
請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。
描述必需15 分
圖示10 分
文件15 分
授權條款10 分

其他 Gemina 整合

Gemina FileTag

co.gemina

Gemina 託管的 MCP 伺服器，可為 PDF 與圖片標記、擷取欄位並搜尋，讓助理整理文件並查詢已建立索引的檔案庫。

STDIO僅桌面

檔案與儲存尚未驗證Oct 24, 2026