MCP-server för Tidvis Staff

Native MCP-server (Streamable HTTP) plus Stripe-checkout som agenten kan starta själv. Samma bearer-nyckel som REST, samma webhooks.

Snabbstart REST-API-docs

Native MCP-server

Streamable HTTP per spec 2025-06-18. Discovery via /.well-known/mcp.json.

Agentic payments

Start, Växa eller pass-credits — agenten kan starta Stripe-checkout direkt.

Wrappar REST 1:1

Inga nya konton, ingen ny auth — samma bearer-API-nyckel.

Webhooks + audit

HMAC-signerade webhooks och full event-historik via list_staffing_request_events.

Snabbstart

Endpoint:

https://staff.tidvis.se/api/public/v1/mcp

Lista verktyg:

curl -s https://staff.tidvis.se/api/public/v1/mcp \
  -H "Authorization: Bearer tvv_live_…" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Anropa ett verktyg (kontoinfo):

curl -s https://staff.tidvis.se/api/public/v1/mcp \
  -H "Authorization: Bearer tvv_live_…" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_account","arguments":{}}}'

Verktyg

Namn	Gör
create_staffing_request	Starta nytt bemanningsuppdrag.
get_staffing_request	Status och resultat för ett uppdrag.
list_staffing_request_events	Hela event-historiken.
cancel_staffing_request	Avbryt pågående uppdrag.
get_account	Info om organisation och nyckelpermissioner.
create_checkout	Starta Stripe-checkout för plan eller credits.

Autonom bokning

create_staffing_request accepterar samma rules-objekt som REST-API:t. För att låta agenten avsluta hela flödet utan mänskligt klick — sätt requireManagerApproval: false. Då bokas första kandidat i prio-listan som svarar accepted med confidence ≥ minConfidenceForAutoBook, och uppdraget går direkt till completed.

curl -s https://staff.tidvis.se/api/public/v1/mcp \
  -H "Authorization: Bearer tvv_live_…" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":4,"method":"tools/call",
       "params":{"name":"create_staffing_request",
                 "arguments":{
                   "externalId":"shift_83922",
                   "shift":{"id":"shift_83922","startTime":"2026-06-24T08:00:00+02:00","endTime":"2026-06-24T16:00:00+02:00","role":"Personlig assistent"},
                   "candidates":[{"id":"u1","name":"Sara","phone":"+46701234567","priority":1}],
                   "rules":{"requireManagerApproval":false,"minConfidenceForAutoBook":0.9,"stopWhenAccepted":true}
                 }}}'

Behåll defaulten requireManagerApproval: true om en samordnare alltid ska bekräfta — då hamnar accepterade kandidater i requires_review istället. Full fältreferens finns i REST-docs · Regler & autonomi.

Agentic payments — två modeller

Plan-abonnemang

staff_start_monthly eller staff_grow_monthly. Återkommande Stripe-subscription, hanterad av kunden.

Pass-credits

staff_filled_shift_credit. Engångsköp à 100 pass per quantity — bra för pilot eller säsongstoppar.

Exempel:

curl -s https://staff.tidvis.se/api/public/v1/mcp \
  -H "Authorization: Bearer tvv_live_…" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call",
       "params":{"name":"create_checkout",
                 "arguments":{"product":"staff_grow_monthly","quantity":1}}}'

Svaret innehåller url — visa den för slutanvändaren. När checkout är klar uppdateras kontot via Stripe-webhook och planen är aktiv.

FAQ

Vad är MCP?

Model Context Protocol — ett öppet protokoll för att exponera verktyg, resurser och prompts för AI-agenter. Tidvis Staff MCP följer Streamable HTTP-spec 2025-06-18 så att klienter som Claude Desktop, Cursor och egna agenter kan koppla in sig direkt.

Vad betyder agentic payments?

Att AI-agenten själv kan initiera betalningar. Tidvis Staff stödjer två modeller: månadsabonnemang (Start eller Växa) och engångsköp av pass-credits. Agenten kallar create_checkout, får tillbaka en hosted Stripe-URL och visar den för slutanvändaren — checkout sker i webbläsaren, inte i agenten.

Vilken auth används?

Samma bearer-API-nyckel som REST-API:t. Skicka Authorization: Bearer tvv_live_… i HTTP-headern på varje POST-anrop till /api/public/v1/mcp.

Skiljer sig MCP-flödet från REST?

Nej — MCP-verktygen är 1-till-1-wrappers runt befintliga REST-endpoints. Använd det som passar agentens transport. Webhooks levereras likadant oavsett vilken kanal som startade uppdraget.