MCP-server

PraxisOS eksponeret som Model Context Protocol-server · Claude Code, Cursor og andre agenter kan styre platformen direkte.

manifest →MCP spec ↗

Tools

JSON-RPC 2.0 over HTTP

Resources

2 tenants + 9 agenter

Protocol

2024-11-05

MCP-standard

Auth

Bearer sk_live_

api-key fra /admin/api

Tilkobling fra Claude Code

Tilføj denne config til ~/.claude/mcp.json (eller projekt-lokalt .mcp.json):

{
  "mcpServers": {
    "praxisos": {
      "type": "http",
      "url": "https://api.praxis.app/api/mcp/v1",
      "headers": {
        "Authorization": "Bearer sk_live_8f2a9c47bf24c3d18a47b2c1d59e8f47"
      }
    }
  }
}

Fra Cursor

{
  "mcp.servers": {
    "praxisos": {
      "url": "https://api.praxis.app/api/mcp/v1",
      "auth": { "bearer": "sk_live_..." }
    }
  }
}

Test direkte med curl

curl -X POST https://api.praxis.app/api/mcp/v1 \
  -H "Authorization: Bearer sk_live_8f2a9c47bf24c3d18a47b2c1d59e8f47" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "tools/call",
    "params": {
      "name": "calculate_subsidy",
      "arguments": {
        "clientId": "per",
        "serviceId": "fod-med",
        "servicePriceKr": 495
      }
    }
  }'

19 tools eksponeret

scopes håndhævet pr. tool

list_bookingsbookingsrequires scope: read:bookings

Liste over bookings for en tenant, filtreret efter status, klient eller datointerval.

Input schema

tenantstringpåkrævet

Tenant-slug (fx 'bypilar')

statusstringconfirmed | completed | pending | noshow | cancelled

Filtrer efter status

clientIdstring

Filtrer efter klient-ID (valgfri)

limitnumber

Maks antal resultater (default: 25)

Output-eksempel

{
  "count": 9,
  "bookings": [
    {
      "id": "bk_a1",
      "clientName": "Mette L.",
      "service": "Hudanalyse",
      "startsAt": "2026-06-12T14:00:00"
    }
  ]
}

Supporterede JSON-RPC metoder

initializeHandshake · returnerer protocol version + capabilities

tools/listListe alle tilgængelige tools

tools/callEksekverer et tool med arguments

resources/listListe tenants + agenter som resources

resources/readHent en specifik resource (praxisos://tenant/X eller agent/X)

prompts/listListe prompts (tom indtil videre)

pingLiveness-check

Hvad får du af at eksponere PraxisOS som MCP?

Claude Code og Cursor kan kalde booking-, journal-, tilskuds- og betalings-flowet direkte.
3.-parts agenter kan automatisere arbejdsgange uden custom-integration.
Hvert tool har scope-tjek + audit-log · ingen privileged operations uden Bearer-token.
JSON-Schema validering på input · runtime-fejl returneres som JSON-RPC -32602.
Resources lader agenter introspecte tenants og agent-teamet uden tools.