Sett opp Claude Desktop

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

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

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

3. Koble til Claude Desktop

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

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

Tre env-variabler totalt: SONENTA_TOKEN (påkrevd), SONENTA_PROJECT (valgfri — pre-scope et prosjekt slik at agenten ikke trenger å kalle list_projects først) og SONENTA_API_BASE (valgfri — default https://api.sonenta.com; overstyr for self-hosted eller staging).

SONENTA_PROJECTS krever @sonenta/mcp ≥ 0.11.0. På eldre releaser, se Bakoverkompatibilitet lenger ned.

Flerprosjekts verktøykall

Når SONENTA_PROJECTS lister mer enn én UUID, kan ikke agenten gjette hvilket prosjekt du mener — hvert verktøykall må inkludere project_uuid. Med én enkelt UUID (eller bare den eldre SONENTA_PROJECT satt), er det valgfritt og kallet faller tilbake på det prosjektet.

1// list_missing_keys — project_uuid is REQUIRED when SONENTA_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}

Formuler prompten din med prosjektet i tankene («i Checkout-prosjektet, list manglende nøkler for ja») — agenten vil løse prosjektet til dets UUID og sende project_uuid på verktøykallet. For prompter som er tvetydige på tvers av flere prosjekter, vil agenten kalle list_projects først.

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.sonenta-oppføringen er identisk.

1// .cursor/mcp.json (project-scoped) or ~/.cursor/mcp.json (user-scoped)2{3  "mcpServers": {4    "sonenta": {5      "command": "npx",6      "args": ["-y", "@sonenta/mcp"],7      "env": { "SONENTA_API_KEY": "snt_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.

Grenser og kvoter per plan

Du betaler når en agent muterer prosjektet ditt, ikke når den observerer det. Lesinger og listinger er gratis; skrivinger bruker én enhet; bulk- og AI-assisterte operasjoner skaleres med arbeidet de gjør.

Hva som teller som et fakturerbart kall

Tak per plan

Månedlig kvote, hard rate per minutt, samtidige MCP-økter, og hvorvidt skrivinger er tillatt. De samme tallene mater X-MCP-Quota-Remaining-headeren på hvert svar.

Når du treffer et tak

Over raten per minutt → 429 mcp_rate_limited med Retry-After (sekunder). Over den månedlige kvoten → 429 mcp_quota_exceeded med Retry-After satt til rolloveren. Skrivinger på Free-planen → 403 mcp_writes_disabled. Kvotene tilbakestilles den 1. i hver kalendermåned, UTC.

Verifiser at det fungerer

1. 1 Restart Claude Desktop helt (avslutt, start på nytt — config-en leses ved oppstart).
2. 2 Åpne en ny chat. Hammer-ikonet skal vise sonenta med 5 verktøy tilgjengelig.
3. 3 Skriv "List my Sonenta 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.