MCP

API-referens

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

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

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.