Documentatie

AI-agents (MCP)

De MCP-server koppelen

Koppel Claude, Claude Code, ChatGPT, Cursor, VS Code of Codex via MCP aan je AmICited-workspace. Eén URL, OAuth-login en een API-sleutel als alternatief.

AmICited draait een altijd actieve MCP-server (Model Context Protocol). Zodra je AI-client is gekoppeld, kan hij je zichtbaarheidsdata lezen, rapporten uitvoeren en, met schrijftoegang, prompts toevoegen, artikelen genereren of annotaties vastleggen, allemaal vanuit een gewoon gesprek. Elke dashboardfunctie is ook beschikbaar als MCP-tool, dus er is niets wat je in de app kunt doen dat een agent niet kan.

Voordat je begint#

  • Een abonnement met MCP. MCP is beschikbaar tijdens de proefperiode van 7 dagen en bij Pro, Premium en Enterprise. Starter-workspaces kunnen de server-URL zien, maar koppelingen worden geweigerd totdat het abonnement is geüpgraded. Zie abonnementen en limieten.
  • Editor-rechten of hoger in de workspace. De pagina MCP vertelt leden zonder die rechten dat ze een workspace-owner of admin moeten vragen.
  • Een positief creditsaldo. Leesverzoeken via MCP zijn gratis, maar het endpoint controleert of de workspace credits heeft voordat het antwoordt. Zie credits.

De server-URL#

Er is één URL voor iedereen:

text
https://api.flowhunt.io/mcp/amicited

De workspace staat niet in de URL. Die komt uit je referentie: bij OAuth kies je de workspace op het toestemmingsscherm en een API-sleutel hoort al bij één workspace. Je kunt de URL ook kopiëren van de pagina MCP in de app, die hem toont met een knop Copy URL en dezelfde instructies per client als hieronder. Het transport is streamable HTTP.

Koppel je client#

Kies je client. Elk tabblad begint met de aanbevolen OAuth-login en eindigt met het alternatief met een API-sleutel.

Claude (web en Desktop)

Connectors die je op claude.ai toevoegt, zijn ook beschikbaar in de Claude Desktop-app.

  1. Open de connectorinstellingen van Claude.
  2. Klik op + en daarna op Add custom connector.
  3. Plak https://api.flowhunt.io/mcp/amicited en klik op Add.
  4. Klik op Connect bij de nieuwe connector en keur de toegang goed in het browservenster dat opent. Kies je workspace op het toestemmingsscherm.

Open in een chat het toolsmenu en controleer of de AmICited-connector is ingeschakeld.

Alternatief met API-sleutel (configuratiebestand van Claude Desktop). Voeg dit toe onder mcpServers in ~/Library/Application Support/Claude/claude_desktop_config.json op macOS en herstart daarna Claude Desktop:

claude_desktop_config.json
{
  "mcpServers": {
    "amicited": {
      "type": "http",
      "url": "https://api.flowhunt.io/mcp/amicited",
      "headers": {
        "Authorization": "Bearer <your-workspace-api-key>"
      }
    }
  }
}

Claude Code

Registreer de server eenmalig vanuit je terminal:

bash
claude mcp add --transport http amicited https://api.flowhunt.io/mcp/amicited

Voer daarna /mcp uit in Claude Code, kies Authenticate en keur de toegang goed in het browservenster dat opent.

Alternatief met API-sleutel. Voeg de server toe onder de mcpServers-sleutel op het hoogste niveau in ~/.claude.json en herstart Claude Code:

~/.claude.json
{
  "mcpServers": {
    "amicited": {
      "type": "http",
      "url": "https://api.flowhunt.io/mcp/amicited",
      "headers": {
        "Authorization": "Bearer <your-workspace-api-key>"
      }
    }
  }
}

ChatGPT

Aangepaste MCP-connectors vereisen Developer mode, dat beschikbaar is bij betaalde ChatGPT-abonnementen (Plus, Pro, Team, Enterprise). In Business-, Enterprise- en Edu-workspaces moet een beheerder het mogelijk voor je inschakelen.

  1. Zet Developer mode aan zoals beschreven in de connectordocumentatie van OpenAI.
  2. Open in ChatGPT Settings en daarna Apps & Connectors.
  3. Voeg een aangepaste connector toe en plak https://api.flowhunt.io/mcp/amicited.
  4. Keur de toegang goed in het browservenster dat opent.

Alternatief met API-sleutel. Kies bij stap 4 in plaats daarvan authenticatie met API-sleutel en plak je workspace-API-sleutel. Sla de connector op en schakel hem daarna in een nieuwe chat in.

Cursor

Selecteer op de pagina MCP van de app Cursor en klik op Add to Cursor. Cursor installeert de server en regelt het inloggen voor je.

Als de knop Cursor niet opent, voeg je de server handmatig toe in de instellingen van Cursor onder MCP, of bewerk je ~/.cursor/mcp.json (of een .cursor/mcp.json per project):

~/.cursor/mcp.json
{
  "mcpServers": {
    "amicited": {
      "url": "https://api.flowhunt.io/mcp/amicited"
    }
  }
}

Cursor opent de eerste keer dat het verbinding maakt een browser om in te loggen. Zet de chat op de modus Agent om de tools te gebruiken.

Alternatief met API-sleutel. Voeg een header toe aan dezelfde vermelding:

json
"headers": { "Authorization": "Bearer <your-workspace-api-key>" }

VS Code

VS Code gebruikt de server via GitHub Copilot in Agent mode, dus Copilot moet zijn ingeschakeld.

Selecteer op de pagina MCP van de app VS Code en klik op Add to VS Code. VS Code installeert de server en regelt het inloggen voor je.

Om hem handmatig toe te voegen, open je het Command Palette, voer je MCP: Open User Configuration uit en voeg je de server toe onder servers:

mcp.json
{
  "servers": {
    "amicited": {
      "type": "http",
      "url": "https://api.flowhunt.io/mcp/amicited"
    }
  }
}

Alternatief met API-sleutel. Voeg "headers": { "Authorization": "Bearer <your-workspace-api-key>" } toe aan de vermelding. Je kunt ook MCP: Add Server… uitvoeren, HTTP (HTTP or Server-Sent Events) kiezen, de URL plakken en de Authorization-header toevoegen wanneer erom wordt gevraagd.

Codex

Codex koppelt als standaard externe MCP-client. Voeg de server toe en log daarna in:

bash
codex mcp add amicited --url https://api.flowhunt.io/mcp/amicited
codex mcp login amicited

Of bewerk ~/.codex/config.toml direct:

~/.codex/config.toml
[mcp_servers.amicited]
url = "https://api.flowhunt.io/mcp/amicited"
oauth_resource = "https://api.flowhunt.io/mcp/amicited"

Alternatief met API-sleutel. Zet de sleutel in een omgevingsvariabele en verwijs Codex ernaar:

~/.codex/config.toml
[mcp_servers.amicited]
url = "https://api.flowhunt.io/mcp/amicited"
bearer_token_env_var = "AMICITED_API_KEY"

Codex-runs met strikte goedkeuringsinstellingen bereiken nog steeds elke alleen-lezentool via read_tool. Zie toolsets en tools.

OAuth of API-sleutel#

OAuth 2.1 (aanbevolen)Workspace-API-sleutel (alternatief)
SetupPlak de URL, keur goed in de browserPlak de URL plus een Authorization: Bearer-header
WorkspaceGekozen op het toestemmingsschermVastgelegd door de sleutel
Rechtenamicited:read om te koppelen en te lezen; amicited:write is ook nodig voor schrijfactiesVolledige toegang tot de workspace
IntrekkenConnected clients → Revoke op de pagina MCPVerwijder de sleutel of laat hem verlopen

OAuth is de betere standaard: je hoeft geen geheim in een configuratiebestand te plakken, elke client verschijnt op naam op de pagina MCP onder Connected clients en je kunt er een intrekken zonder de andere aan te raken. Een OAuth-token met alleen leesrechten kan alles opsommen en lezen, maar elke tool die aanmaakt, bewerkt of verwijdert, weigert met een bericht waarin de scope amicited:write wordt genoemd. Opnieuw proberen helpt niet; koppel opnieuw met schrijftoegang.

Behandel een API-sleutel als een wachtwoord

Iedereen met een workspace-API-sleutel kan elke tool op de server uitvoeren op je workspacedata, inclusief schrijfacties. Geef de voorkeur aan OAuth, houd sleutels uit gedeelde repositories en gebruik een omgevingsvariabele waar je client die ondersteunt.

Controleer of het werkt#

Vraag je agent iets kleins: “List my AmICited domains.” Hij zou list_domains moeten aanroepen en je domeinen op naam teruggeven. Probeer daarna “Show my AI visibility for the last 30 days”, dat prompt_analytics gebruikt.

Als de koppeling wordt geweigerd, zegt het bericht meestal waarom:

  • Abonnement. “requires a Pro plan or above”: het abonnement van de workspace-owner bevat geen MCP.
  • Credits. Het saldo van de workspace is nul of negatief. Laad bij en probeer opnieuw.
  • Ratelimiet. Toolaanroepen zijn per workspace per uur begrensd: 120 in de proefperiode, 600 bij Pro, 2.000 bij Premium, onbeperkt bij Enterprise. Het bericht zegt wanneer het venster wordt gereset. Tools opsommen en skills lezen tellen niet mee.

Gerelateerd#