MCP

Sätt upp Claude Desktop

Verbumia levererar en nativ MCP-server så att vilken MCP-medveten klient som helst — Claude Desktop, Cursor, din egen agent — kan söka nycklar, föreslå översättningar, granska PRs och inspektera missing-key-kön. Två rader config, din token, klart.

1. Hämta en API-nyckel

I din dashboard, gå till Org Settings → API Keys → Create. Ge den scope mcp:* (täcker alla fem verktyg nedan). Hemligheten visas en gång; kopiera hela vrb_live_<prefix>.<secret>-strängen.

Förvara den i OS:ets keychain eller en lokal .env — committa aldrig. Nyckeln är bunden till din org (och valfritt ett projekt); anrop utanför scope returnerar 404. Återkalla från dashboarden när som helst; återkallade nycklar 401:ar vid nästa anrop.

2. Installera (eller hoppa över)

MCP-servern publiceras på npm och Homebrew. Med npx behöver du inte installera något — Claude Desktop drar senaste versionen vid varje start. Med brew får du en pinnad lokal binär, användbar bakom strikta brandväggar.

npx (rekommenderat)

1// ingen installation behövs — npx drar senaste @verbumia/mcp on demand2npx -y @verbumia/mcp --version

Homebrew (alternativ) Tap publiceras vid V1

1// valfritt: installera en gång globalt — kommer med V1-lanseringen2brew install verbumia/tap/verbumia-mcp

3. Koppla Claude Desktop

Öppna Claude Desktops config-fil, lägg till verbumia-posten under mcpServers, avsluta sedan och starta om appen.

claude_desktop_config.json

1// macOS:   ~/Library/Application Support/Claude/claude_desktop_config.json2// Windows: %APPDATA%/Claude/claude_desktop_config.json3{4  "mcpServers": {5    "verbumia": {6      "command": "npx",7      "args": ["-y", "@verbumia/mcp@^0.11.0"],8      "env": {9        "VERBUMIA_API_KEY": "vrb_live_<prefix>.<secret>",10        "VERBUMIA_PROJECTS": "<uuid1>,<uuid2>"11      }12    }13  }14}

Tre env-variabler totalt: VERBUMIA_TOKEN (krävs), VERBUMIA_PROJECT (valfri — pre-scope:a ett projekt så agenten inte behöver anropa list_projects först) och VERBUMIA_API_BASE (valfri — default https://api.verbumia.dev; överskrid för self-hosted eller staging).

VERBUMIA_PROJECTS requires @verbumia/mcp ≥ 0.11.0. On older releases, see Backwards compatibility below.

Multi-project tool calls

When VERBUMIA_PROJECTS lists more than one UUID, the agent can't infer which project you mean — every tool call must include project_uuid. With a single UUID (or only the legacy VERBUMIA_PROJECT set), it's optional and defaults to that project.

tools/call arguments

1// list_missing_keys — project_uuid is REQUIRED when VERBUMIA_PROJECTS lists more than one UUID2{3  "name": "list_missing_keys",4  "arguments": {5    "project_uuid": "<uuid1>",6    "namespace": "checkout",7    "language_code": "ja"8  }9}

Phrase your prompt with the project in mind (« in the Checkout project, list missing keys for ja ») — the agent will resolve the project to its UUID and pass project_uuid on the tool call. For ambiguous prompts across multiple projects, the agent will call list_projects first.

Cursor (och andra MCP-klienter)

Samma JSON, annan fil. I Cursor lägg den i .cursor/mcp.json (projekt-scope) eller ~/.cursor/mcp.json (user-scope). För andra klienter, följ klientens MCP-config-docs — mcpServers.verbumia-posten är identisk.

.cursor/mcp.json

1// .cursor/mcp.json (project-scoped) or ~/.cursor/mcp.json (user-scoped)2{3  "mcpServers": {4    "verbumia": {5      "command": "npx",6      "args": ["-y", "@verbumia/mcp@^0.11.0"],7      "env": { "VERBUMIA_API_KEY": "vrb_live_<prefix>.<secret>" }8    }9  }10}

De 5 V1-verktygen

När det är konfigurerat har agenten dessa verktyg tillgängliga. Du anropar dem inte med namn — beskriv din avsikt i chatten så väljer agenten. Namnen nedan är de kanoniska identifierarna, användbara när du läser agent-trace eller bygger egna agenter ovanpå samma server.

list_projects Räknar upp projekten som aktuell API-nyckel kan komma åt. Användbart för att välja workspace i början av en chat.

Args

limit number valfritt tak på antalet projekt som returneras

Exempelprompt

"List my Verbumia projects."

get_project_info Hämtar projektmetadata: källspråk, målspråk, namespaces, totalt antal nycklar.

Args

project_uuid string required

Exempelprompt

"What languages and namespaces does the Checkout project ship?"

list_missing_keys Listar pending missing-key-events fångade av runtime-SDK:n (cursor-paginerat). Filtrera på namespace eller språk.

Args

project_uuid string required
namespace string begränsa till ett namespace (t.ex. "checkout")
language_code string begränsa till ett språk (t.ex. "ja")
cursor string pagineringscursor returnerad av tidigare anrop
limit number sidstorlek (default 20)

Exempelprompt

"What translation keys are missing for ja in the checkout namespace?"

propose_translation Skickar in ett översättningsvärde för en nyckel på ett målspråk. Skrivs alltid som draft; en mänsklig granskare promotar senare — Verbumia är förvaltaren, inte motorn.

Args

project_uuid string required
key string required
namespace string required
language_code string required
value string required

Exempelprompt

"Propose \"Confirmer la commande\" for checkout.review.confirm in fr-CA."

validate_translations Lintar en JSON-i18next-payload före push: ICU-placeholder-paritet, saknade/extra nycklar, type-drift mellan locales.

Args

project_uuid string required
language_code string required
payload object required JSON-i18next-formad översättningsmap

Exempelprompt

"Validate this translation file against the project's English source."

Plan limits & quotas

You pay when an agent mutates your project, not when it observes it. Reads and listings are free; writes burn one unit; bulk and AI-assisted ops scale with the work they do.

What counts as a billable call

Reads — free

list_missing, list_keys, get_translation, search, plus auth / discover / meta. Browse the missing-key queue all day — it never touches your quota.

Writes — 1 unit

Each set / create / update / delete on a key or translation costs one unit, regardless of payload size.

Bulk — 1 unit per key

Multi-key endpoints (e.g. acknowledge) bill per key touched: a 50-key acknowledge debits 50 units, with rollback on partial-reject.

AI / auto-translate — ×5

Calls that invoke an LLM (auto-translate, AI Quality Review, suggest) bill 5 units per call. Higher weight reflects model cost.

Per-plan ceilings

Monthly quota, hard per-minute rate, concurrent MCP sessions, and whether writes are allowed. The same numbers feed the X-MCP-Quota-Remaining header on every response.

Plan	Units / month	Rate	Sessions	Writes
Free	NaN	NaNreq/min	NaN	blocked
Hobby	NaN	NaNreq/min	NaN	blocked
Pro	NaN	NaNreq/min	NaN	blocked
Team	NaN	NaNreq/min	NaN	blocked

When you hit a ceiling

Over the per-minute rate → 429 mcp_rate_limited with Retry-After (seconds). Over the monthly quota → 429 mcp_quota_exceeded with Retry-After set to the rollover. Free plan writes → 403 mcp_writes_disabled. Quotas reset on the 1st of each calendar month, UTC.

Verifiera att det funkar

1 Starta om Claude Desktop helt (avsluta, starta om — config:en läses vid uppstart).
2 Öppna en ny chat. Hammar-ikonen ska visa verbumia med 5 verktyg tillgängliga.
3 Skriv "List my Verbumia projects." Agenten ska anropa list_projects och returnera dina workspaces.

Fast? Kolla Claude Desktops loggar i ~/Library/Logs/Claude/mcp*.log (macOS). 90 % av problemen är typos i JSON:en eller en gammal token.

Backwards compatibility

Tidigare namn VERBUMIA_TOKEN och VERBUMIA_API_BASE (före 0.4.0) accepteras fortfarande som fallback; SDK:n läser dem tyst om de kanoniska inte är satta.

Nästa

Snabbstart

React + i18next

Fånga saknade nycklar i runtime, end-to-end.

Referens

Alla docs

CLI, API-referens (pågår).