Een MCP-client koppelen

Optie A — OAuth (aanbevolen)

Bij clients die externe MCP-servers met OAuth ondersteunen, vul je gewoon de URL hierboven in. De client vindt onze autorisatieserver vanzelf, opent een browser om in te loggen en toont een toestemmingsscherm waarin je kiest waar de agent bij mag. Geen tokens om te kopiëren. Toegangstokens zijn kortlevend en vernieuwen automatisch, en je kunt elke app op elk moment loskoppelen via MCP-instellingen.

We beginnen met alleen-lezen-scopes — geef alleen schrijf- of beheerderstoegang als je wilt dat de agent je data aanpast.

Optie B — Persoonlijk toegangstoken (ontwikkelaars / power users)

Maak een token met scopes aan in MCP-instellingen en stuur het mee als Bearer-header. Het handigst voor lokale ontwikkeling en CLI-agents. Het token wordt één keer getoond — bewaar het als een wachtwoord.

Clients die een externe URL + headers accepteren:

{
  "mcpServers": {
    "hardlysimple": {
      "url": "https://i8n.hardlysimple.com/mcp",
      "headers": {
        "Authorization": "Bearer ${HARDLYSIMPLE_PAT}"
      }
    }
  }
}

Clients die alleen een lokale (stdio-)bridge draaien — gebruik mcp-remote:

{
  "mcpServers": {
    "hardlysimple": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://i8n.hardlysimple.com/mcp"
      ]
    }
  }
}

Met mcp-remote kun je het token meegeven via --header Authorization:"Bearer $HARDLYSIMPLE_PAT", of de OAuth-flow in je browser laten draaien (laat de header weg). Plak nooit een token in een client die je niet vertrouwt.

Tips per client

• ChatGPT — zet Developer Mode / aangepaste connectors aan, voeg de MCP-server-URL hierboven toe en rond de OAuth-toestemming af. Begin met alleen-lezen-scopes.
• Claude / Cursor — als de client externe MCP-servers ondersteunt, voeg je de URL toe en geef je toestemming via OAuth. Ondersteunt hij alleen lokale/stdio-configuratie, gebruik dan de mcp-remote-bridge hierboven.
• Codex / CLI-agents — gebruik de PAT-Bearer-header of de mcp-remote-bridge.

Scopes

Scopes beperken wat een koppeling mag doen; ze geven nooit meer dan je eigen account al heeft.

• Je werkruimte lezen — Je teams, taken, schetsen, decks (presentaties en beslisdecks), kennisbundels, databanks, designsystemen, gestructureerde data, repository's, Claude-artefacten en agentworkflows bekijken.
  hardlysimple:teams:readhardlysimple:tasks:readhardlysimple:sketches:readhardlysimple:knowledge-bundles:readhardlysimple:databanks:readhardlysimple:design-systems:readhardlysimple:structured-data:readhardlysimple:repositories:readhardlysimple:claude-artifacts:readhardlysimple:presentations:readhardlysimple:halfabs:readhardlysimple:decks:readhardlysimple:workflows:read
• Je werkruimte bewerken — Je taken, schetsen, decks (presentaties en beslisdecks), kennisbundels, databanks, designsystemen van je team, gestructureerde data, repository's, opgeslagen Claude-artefacten en concepten van agentworkflows aanmaken en bijwerken.
  hardlysimple:tasks:writehardlysimple:sketches:writehardlysimple:knowledge-bundles:writehardlysimple:databanks:writehardlysimple:design-systems:writehardlysimple:structured-data:writehardlysimple:repositories:writehardlysimple:claude-artifacts:writehardlysimple:presentations:writehardlysimple:halfabs:writehardlysimple:decks:writehardlysimple:workflows:write
• Bestanden uploaden — Afbeeldingen en bestanden uploaden naar je databanks en naar taakkaarten.
  hardlysimple:databanks:uploadhardlysimple:tasks:upload
• Je profiel lezen — Je naam, e-mailadres en profielgegevens bekijken.
  hardlysimple:profile:read
• Taaktoewijzingen beheren — Zien wat aan jou is toegewezen en mensen aan taken toewijzen.
  hardlysimple:tasks:assign:readhardlysimple:tasks:assign:write
• Companion-sessies — Zichzelf identificeren (provider, model, effort) en het eigen werk als sessie bijhouden.
  hardlysimple:companions:readhardlysimple:companions:write
• Je agenda — Je samengevoegde agenda bekijken — inclusief gekoppelde Google-accounts — en afspraken toevoegen aan of verwijderen uit je eigen agenda's.
  hardlysimple:calendar:readhardlysimple:calendar:write
• Betalingen voorbereiden — Een prijsopgave voor een abonnement maken en een betaallink klaarzetten, zodat jij betaalt op de eigen factuurpagina van HardlySimple. De agent ziet nooit kaartgegevens en kan niet betalen.
  hardlysimple:billing:readhardlysimple:billing:write
• Je werkruimte beheren — Volledige beheerderstoegang (werkt alleen als je account beheerder is).
  hardlysimple:admin