MCP

Met MCP (Model Context Protocol) laten tools als Cursor en Claude de Tillor API voor je aanroepen. Je logt een keer in via OAuth; in je config hoeft geen API-sleutel te staan.

URL: https://mcp.tillor.dev

Wat je ermee kunt

Na verbinding kun je in de AI-tool:

API-categorieën en endpoints bekijken (uit de OpenAPI-specificatie)
Endpoints aanroepen met jouw rechten in de gekozen organisatie

Dat loopt over dezelfde REST API als de HTTP API. Wat je mag doen, hangt af van je Tillor-account en je permissies in die organisatie.

Authenticatie

De tool verbindt met https://mcp.tillor.dev zonder token
OAuth discovery en registratie lopen op het MCP-host; login/consent op Tillor
Je keurt de toegang goed in de browser
De tool stuurt daarna een Bearer-token mee bij MCP-calls

Stuur altijd je organisatie mee als header:

X-Tillor-Org-Id: org_abc123

Zonder die header weet de server niet in welke organisatie de calls horen.

Geen API-sleutel nodig

Voor de hosted MCP-server gebruik je OAuth (Connect / Authorize in de tool). Voor scripts en eigen integraties blijf je API-sleutels gebruiken.

Cursor

Zet Tillor in je globale MCP-config (bijvoorbeeld ~/.cursor/mcp.json), dan heb je het in elk project:

{
  "mcpServers": {
    "Tillor": {
      "url": "https://mcp.tillor.dev",
      "headers": {
        "X-Tillor-Org-Id": "org_abc123"
      }
    }
  }
}

Vervang org_abc123 door je organisatie-ID. Herlaad de MCP-servers in Cursor en kies bij Tillor Connect of Authorize.

Claude

In Claude Desktop of op claude.ai voeg je de server toe als connector. Zet geen url-entry in claude_desktop_config.json; die lokale config is alleen voor stdio-servers.

Ga naar Settings > Connectors (of Customize > Connectors)
Voeg een custom connector toe met URL https://mcp.tillor.dev (exact zo, zonder trailing slash)
Laat OAuth Client ID / Secret leeg (dynamic registration)
Klik Connect en rond de Tillor-login af

Tools

Tool	Doel
`list_api_categories`	Lijst API-categorieën
`list_api_endpoints`	Endpoints in een categorie, met inputschema
`get_api_endpoint_schema`	Schema van één endpoint op naam
`call_api_endpoint`	Roept een endpoint aan

Endpointnamen zijn geen losse tools — gebruik call_api_endpoint.

De volledige REST-referentie blijft OpenAPI. MCP is een laag daarop, geen aparte product-API.

Gerelateerd

HTTP API - API-sleutels, headers en base URL
OpenAPI - Volledige API-specificatie
API Playground - Endpoints uitproberen in de browser