MCP

API-referanse

Verbumia ships a native MCP server so any MCP-aware client — Claude Desktop, Cursor, your own agent — can search keys, propose translations, review PRs, and inspect the missing-key queue. Two lines of config, your token, done.

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. Install (or skip)

The MCP server is published to npm and Homebrew. With npx you don't need to install anything — Claude Desktop pulls the latest version on every launch. With brew you get a pinned local binary, useful behind strict firewalls.

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"],8      "env": {9        "VERBUMIA_TOKEN":   "vrb_live_<prefix>.<secret>",10        "VERBUMIA_PROJECT": "<project_uuid>"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.ca; overstyr for self-hosted eller staging).

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"],7      "env": { "VERBUMIA_TOKEN": "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."

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.