Hoe je Claude, Cursor en andere AI-apps koppelt met MCP
Elke werkruimte heeft een MCP-server. AI-apps zoals Claude, Claude Code, Cursor, Codex en Gemini CLI koppelen eraan met een persoonlijke sleutel, en lezen en werken daarna je werk bij als jij, met jouw rechten. Waarom dit nuttig is, staat op MCP in Worknano. Deze pagina is de inrichting.
Zet het aan (admins)
- Open Organization en klik Settings. Onder MCP Server zet je Enable MCP Server aan. Hij blijft uit tot een admin hem aanzet.
- Open Config, klik Integrations, daarna MCP Server. Elke app (Claude, Cursor, Codex, Gemini) is een verbindingstemplate. Zet een template uit en elke sleutel die eruit is gemaakt, stopt met werken.
- Kies welke modellen elke template mag lezen, maken of bijwerken. Delete staat standaard uit.
- Onder Permissions zet MCP Permissions wat externe verbindingen in de hele werkruimte mogen doen. Zie Permissions.
- Standaard kunnen Founders en Heads verbinden. Wil je andere rollen laten verbinden, geef ze dan create-toegang tot MCP Connection in Permissions.
Koppel je app
- Open My en klik Integrations. Zoek Worknano in other AI apps.
- Klik Connect naast je app. De rij toont de Server URL en je sleutel.
- Kopieer de Server URL. Dat is het adres van je werkruimte met /mcp aan het eind, bijvoorbeeld https://yourcompany.worknano.com/mcp.
- Toon en kopieer de sleutel. Hij begint met wnpat_. Alleen jij kunt hem tonen, en elke keer tonen wordt vastgelegd.
- Volg de gids op de rij voor jouw app. Elke app heeft dezelfde twee dingen nodig: de Server URL, en een Authorization-header waarvan de waarde Bearer is gevolgd door je sleutel.
Claude Code, in één commando:
claude mcp add --transport http --scope user worknano https://yourcompany.worknano.com/mcp --header "Authorization: Bearer YOUR_KEY"
Cursor, in ~/.cursor/mcp.json:
{ "mcpServers": { "worknano": { "url": "https://yourcompany.worknano.com/mcp", "headers": { "Authorization": "Bearer YOUR_KEY" } } } }
Gemini CLI gebruikt httpUrl in plaats van url. Codex heeft Streamable HTTP en dezelfde header nodig. In de Claude-app voeg je een custom connector toe, kies je No sign in en voeg je de header toe. Een connector die een eigenaar voor een heel Claude-team toevoegt, stuurt één sleutel voor iedereen, met de rechten van die sleutel.
Wat de app kan doen
- De werkruimte lezen: modellen, velden, records, tellingen en groepen.
- Records maken en bijwerken in de modellen die je template toestaat.
- Bestanden lijsten, lezen en opslaan (HTML, tekst en boards).
- Configwijzigingen als concepten voorstellen. Er verandert niets tot een admin het concept in Worknano goedkeurt.
Drie grenzen gelden voor elke aanroep: de MCP-instellingen van het model, de grants van je verbinding en je eigen rol. Secrets, gebruikers, rollen en integraties worden nooit blootgesteld.
Sleutels, verval en loskoppelen
- Een sleutel duurt 90 dagen. Als hij verloopt, toont de rij Not connected. Klik Connect voor een nieuwe sleutel en plak hem in je app.
- Klik Disconnect om je sleutel te verwijderen. De app verliest meteen toegang.
Worknano kan ook andere MCP-servers gebruiken binnen de eigen assistenten. Dat is de MCP Client, een aparte schakelaar naast Enable MCP Server. Worknano aanroepen vanuit je eigen code staat in de developer docs. Terug naar de docskaart.