MCP

Sett opp Claude Desktop

Verbumia leverer en nativ MCP-server slik at enhver MCP-bevisst klient — Claude Desktop, Cursor, din egen agent — kan søke etter nøkler, foreslå oversettelser, gjennomgå PR-er og inspisere missing-key-køen. To linjer config, din token, ferdig.

1. Hent en API-nøkkel

I dashbordet, gå til Org Settings → API Keys → Create. Gi den scope mcp:* (dekker alle fem verktøyene nedenfor). Hemmeligheten vises én gang; kopier hele vrb_live_<prefix>.<secret>-strengen.

Lagre den i OS-ets keychain eller en lokal .env — aldri commit. Nøkkelen er bundet til organisasjonen din (og valgfritt ett prosjekt); kall utenfor scope returnerer 404. Tilbakekall fra dashbordet når som helst; tilbakekalte nøkler 401-er ved neste kall.

2. Installer (eller hopp over)

MCP-serveren publiseres på npm og Homebrew. Med npx trenger du ikke installere noe — Claude Desktop henter siste versjon ved hver oppstart. Med brew får du en pinnet lokal binær, nyttig bak strenge brannmurer.

npx (anbefalt)

1// ingen installasjon nødvendig — npx henter siste @verbumia/mcp on demand2npx -y @verbumia/mcp --version

Homebrew (alternativ) Tap publiseres ved V1

1// valgfritt: installer én gang globalt — kommer med V1-lanseringen2brew install verbumia/tap/verbumia-mcp

3. Koble til Claude Desktop

Åpne Claude Desktop sin config-fil, legg til verbumia-oppføringen under mcpServers, så avslutt og start appen på nytt.

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 (påkrevd), VERBUMIA_PROJECT (valgfri — pre-scope et prosjekt slik at agenten ikke trenger å kalle list_projects først) og VERBUMIA_API_BASE (valgfri — default https://api.verbumia.dev; overstyr for 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 (og andre MCP-klienter)

Samme JSON, annen fil. I Cursor legg den i .cursor/mcp.json (prosjekt-scope) eller ~/.cursor/mcp.json (bruker-scope). For andre klienter, følg klientens MCP-config-docs — mcpServers.verbumia-oppføringen er 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-verktøyene

Når det er konfigurert har agenten disse verktøyene tilgjengelig. Du kaller dem ikke ved navn — beskriv intensjonen din i chatten og agenten velger. Navnene nedenfor er de kanoniske identifikatorene, nyttige ved lesing av agent-traces eller bygging av egne agenter på samme server.

list_projects Lister opp prosjektene den nåværende API-nøkkelen har tilgang til. Nyttig for å velge workspace i starten av en chat.

Args

limit number valgfri grense på antall prosjekter som returneres

Eksempelprompt

"List my Verbumia projects."

get_project_info Henter prosjektmetadata: kildespråk, målspråk, namespaces, totalt antall nøkler.

Args

project_uuid string required

Eksempelprompt

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

list_missing_keys Lister pending missing-key-events fanget av runtime-SDK-en (cursor-paginert). Filtrer på namespace eller språk.

Args

project_uuid string required
namespace string begrens til ett namespace (f.eks. "checkout")
language_code string begrens til ett språk (f.eks. "ja")
cursor string pagineringscursor returnert av tidligere kall
limit number sidestørrelse (default 20)

Eksempelprompt

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

propose_translation Sender inn en oversettelsesverdi for en nøkkel i et målspråk. Skrives alltid som draft; en menneskelig reviewer promoterer senere — Verbumia er forvalteren, ikke motoren.

Args

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

Eksempelprompt

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

validate_translations Linter en JSON-i18next-payload før push: ICU-placeholder-paritet, manglende/ekstra nøkler, type-drift mellom locales.

Args

project_uuid string required
language_code string required
payload object required JSON-i18next-formet oversettelsesmap

Eksempelprompt

"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.

Verifiser at det fungerer

1 Restart Claude Desktop helt (avslutt, start på nytt — config-en leses ved oppstart).
2 Åpne en ny chat. Hammer-ikonet skal vise verbumia med 5 verktøy tilgjengelig.
3 Skriv "List my Verbumia projects." Agenten skal kalle list_projects og returnere dine workspaces.

Står fast? Sjekk Claude Desktops logger i ~/Library/Logs/Claude/mcp*.log (macOS). 90 % av problemene er typos i JSON-en eller en utgått token.

Backwards compatibility

De tidligere navnene VERBUMIA_TOKEN og VERBUMIA_API_BASE (før 0.4.0) godtas fortsatt som fallback; SDK-et leser dem stille hvis de kanoniske ikke er satt.

Neste

Hurtigstart

React + i18next

Fang manglende nøkler i runtime, end-to-end.

Referanse

Alle docs

CLI, API-referanse (under arbeid).