WorkOS for AI-agenter
Koble Claude, Cursor, Cline, OpenClaw og enhver MCP-kompatibel klient direkte mot ditt workspace. Én URL, automatisk OAuth, full tilgang til sider, databaser, oppgaver og møter.
Leser du dette som en agent? Hent ren markdown på /for-agenter.md eller indeksen på /llms.txt.
Koble til på 30 sekunder
Lim inn URL-en i MCP-klienten din. OAuth-flyten håndteres automatisk.
- Ingen API-nøkler — OAuth 2.1 med PKCE
- Tilgang knyttet til din konto og dine workspace
- Streamable HTTP, JSON-RPC 2.0, stateless
Installer fra ClawHub
Offisiell skill for OpenClaw — auto-konfigurerer transport og OAuth.
OpenClaw CLI
openclaw skills install zecurecode/workosmcpClawHub CLI
npx clawhub@latest install workosmcpSkill-en lærer agenten når WorkOS skal brukes, dokumenterer alle 201 verktøyene og setter Streamable HTTP-transporten korrekt. Bruker MCP-klienten din ikke OpenClaw, sett opp manuelt med instruksjonene under.
Oppsett per klient
Eksempler for de vanligste MCP-klientene. Alle bruker samme URL og samme OAuth-flyt.
Claude Desktop & Claude.ai
Legg til som remote MCP-server. OAuth-flyten åpnes i nettleseren første gang og lagres deretter automatisk.
{
"mcpServers": {
"workos": {
"url": "https://workos.no/api/mcp"
}
}
}Claude Desktop: legg dette i claude_desktop_config.json. Claude.ai (web): Innstillinger → Connectors → Add custom connector → lim inn URL-en.
Cursor
Cursor støtter remote MCP-servere via Streamable HTTP med automatisk OAuth.
{
"mcpServers": {
"workos": {
"url": "https://workos.no/api/mcp"
}
}
}Settings → MCP → Add new MCP server, eller lim inn i ~/.cursor/mcp.json.
Cline (VS Code)
Cline må eksplisitt bruke Streamable HTTP — ikke SSE. Serveren er stateless og svarer 405 på GET.
{
"mcpServers": {
"workos": {
"type": "streamableHttp",
"url": "https://workos.no/api/mcp"
}
}
}Sett type til "streamableHttp". Eldre SSE-konfigurasjoner vil feile — se Feilsøking lenger ned.
OpenClaw
Installer den offisielle ClawHub-skill-en. Den setter URL, transport og OAuth automatisk og lærer agenten når WorkOS skal brukes.
openclaw skills install zecurecode/workosmcpEller manuelt: openclaw mcp add workos --url https://workos.no/api/mcp.
Tekniske detaljer
For deg som bygger en egen MCP-klient eller vil forstå hva som skjer under panseret.
- Endepunkt
- POST https://workos.no/api/mcp
- Transport
- Streamable HTTP (JSON-RPC 2.0). Stateless — GET returnerer 405, ingen SSE-stream fra server til klient.
- Protokollversjoner
- 2025-06-18, 2025-03-26, 2024-11-05
- Autentisering
- OAuth 2.1 (Authorization Code + PKCE). Bearer-token i
Authorization-headeren. Access token: 1 time. Refresh token: 30 dager. - Scopes
- read, write
- Discovery
- /.well-known/oauth-protected-resource og /.well-known/oauth-authorization-server — pekes ut via 401 + WWW-Authenticate.
Feilsøking
De vanligste grunnene til at en MCP-klient ikke kobler seg til.
Klienten prøver SSE og får 405
Vanligst med eldre Cline-versjoner. WorkOS bruker Streamable HTTP (POST), ikke SSE. Sett "type": "streamableHttp" i konfigurasjonen, eller oppgrader klienten.
OAuth-vinduet åpnes ikke
Klienten må kunne åpne en nettleser for å fullføre samtykke. På fjernmaskiner uten browser må du kopiere autorisasjons-URL-en manuelt og lime den inn i en lokal nettleser.
401 Unauthorized etter en time
Access token utløper etter 60 minutter. MCP-klienter skal automatisk fornye via refresh token. Hvis ikke, fjern serveren og legg den til på nytt for å starte ny OAuth-flyt.
Feil workspace
Tokenet er knyttet til ett workspace. For å bytte: fjern serveren i klienten, logg inn med riktig konto i nettleseren, og legg serveren til på nytt.
Klar til å koble til?
Du trenger en WorkOS-konto for at agenten skal kunne autentisere. Det tar under et minutt å opprette.