Dokumentation

AI-agenter (MCP)

Forbind MCP-serveren

Forbind Claude, Claude Code, ChatGPT, Cursor, VS Code eller Codex til dit AmICited-workspace via MCP. Én URL, OAuth-login og en API-nøgle som reserve.

AmICited kører en altid tændt MCP-server (Model Context Protocol). Når din AI-klient er forbundet, kan den læse dine synlighedsdata, køre rapporter og, med skriveadgang, tilføje prompts, generere artikler eller logge annotationer, alt sammen fra en almindelig samtale. Hver funktion i dashboardet leveres også som et MCP-værktøj, så der er intet, du kan gøre i appen, som en agent ikke kan.

Før du starter#

  • En plan, der inkluderer MCP. MCP er tilgængelig på den 7-dages prøveperiode og på Pro, Premium og Enterprise. Starter-workspaces kan se server-URL’en, men forbindelser afvises, indtil planen opgraderes. Se planer og grænser.
  • Editor-rettigheder eller højere i workspacet. Siden MCP beder medlemmer uden dem om at spørge en workspace-ejer eller administrator.
  • En positiv kreditsaldo. Læsninger via MCP er gratis, men endpointet tjekker, at workspacet har kreditter, før det svarer. Se kreditter.

Server-URL’en#

Der er én URL til alle:

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

Workspacet er ikke i URL’en. Det kommer fra din legitimation: med OAuth vælger du workspacet på samtykkeskærmen, og en API-nøgle hører allerede til ét workspace. Du kan også kopiere URL’en fra siden MCP i appen, som viser den med en knap Copy URL og de samme instruktioner pr. klient som nedenfor. Transporten er streamable HTTP.

Forbind din klient#

Vælg din klient. Hver fane starter med det anbefalede OAuth-login og slutter med API-nøgle-alternativet.

Claude (web og Desktop)

Connectors, du tilføjer på claude.ai, er også tilgængelige i Claude Desktop-appen.

  1. Åbn Claudes connector-indstillinger.
  2. Klik på +, og derefter på Add custom connector.
  3. Indsæt https://api.flowhunt.io/mcp/amicited, og klik på Add.
  4. Klik på Connect på den nye connector, og godkend adgang i det browservindue, der åbner. Vælg dit workspace på samtykkeskærmen.

Åbn værktøjsmenuen i en chat, og sørg for, at AmICited-connectoren er aktiveret.

API-nøgle-alternativ (Claude Desktops konfigurationsfil). Tilføj dette under mcpServers i ~/Library/Application Support/Claude/claude_desktop_config.json på macOS, og genstart derefter 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

Registrér serveren én gang fra din terminal:

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

Kør derefter /mcp i Claude Code, vælg Authenticate, og godkend adgang i det browservindue, der åbner.

API-nøgle-alternativ. Tilføj serveren under nøglen mcpServers på øverste niveau i ~/.claude.json, og genstart Claude Code:

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

ChatGPT

Brugerdefinerede MCP-connectors kræver Developer mode, som er tilgængelig på betalte ChatGPT-planer (Plus, Pro, Team, Enterprise). I Business-, Enterprise- og Edu-workspaces kan en administrator have brug for at aktivere det for dig.

  1. Slå Developer mode til, som beskrevet i OpenAIs connector-dokumentation.
  2. Åbn Settings i ChatGPT, og derefter Apps & Connectors.
  3. Tilføj en brugerdefineret connector, og indsæt https://api.flowhunt.io/mcp/amicited.
  4. Godkend adgang i det browservindue, der åbner.

API-nøgle-alternativ. Vælg i trin 4 API-nøgle-autentificering i stedet, og indsæt din workspace-API-nøgle. Gem connectoren, og aktivér den derefter i en ny chat.

Cursor

Vælg Cursor på appens side MCP, og klik på Add to Cursor. Cursor installerer serveren og kører login for dig.

Hvis knappen ikke åbner Cursor, kan du tilføje serveren manuelt i Cursors indstillinger under MCP eller redigere ~/.cursor/mcp.json (eller en .cursor/mcp.json pr. projekt):

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

Cursor åbner en browser til login første gang, den forbinder. Sæt chatten til Agent-tilstand for at bruge værktøjerne.

API-nøgle-alternativ. Tilføj en header til den samme post:

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

VS Code

VS Code bruger serveren via GitHub Copilot i Agent-tilstand, så Copilot skal være aktiveret.

Vælg VS Code på appens side MCP, og klik på Add to VS Code. VS Code installerer serveren og kører login for dig.

For at tilføje den manuelt skal du åbne Command Palette, køre MCP: Open User Configuration og tilføje serveren under servers:

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

API-nøgle-alternativ. Tilføj "headers": { "Authorization": "Bearer <your-workspace-api-key>" } til posten. Du kan også køre MCP: Add Server…, vælge HTTP (HTTP or Server-Sent Events), indsætte URL’en og tilføje headeren Authorization, når du bliver bedt om det.

Codex

Codex forbinder som en standard MCP-klient til fjernservere. Tilføj serveren, og log derefter ind:

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

Eller redigér ~/.codex/config.toml direkte:

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

API-nøgle-alternativ. Læg nøglen i en miljøvariabel, og peg Codex på den:

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

Codex-kørsler med strenge godkendelsesindstillinger når stadig hvert skrivebeskyttet værktøj via read_tool. Se toolsets og værktøjer.

OAuth eller API-nøgle#

OAuth 2.1 (anbefalet)Workspace-API-nøgle (reserve)
OpsætningIndsæt URL’en, godkend i browserenIndsæt URL’en plus en Authorization: Bearer-header
WorkspaceVælges på samtykkeskærmenFastlagt af nøglen
Tilladelseramicited:read for at forbinde og læse; amicited:write kræves også til skrivningFuld adgang til workspacet
TilbagekaldelseConnected clients → Revoke på siden MCPSlet nøglen, eller lad den udløbe

OAuth er det bedste udgangspunkt: der er ingen hemmelighed at indsætte i en konfigurationsfil, hver klient vises med navn på siden MCP under Connected clients, og du kan tilbagekalde én uden at røre de andre. Et skrivebeskyttet OAuth-token kan liste og læse alt, men ethvert værktøj, der opretter, redigerer eller sletter, afviser med en besked, der nævner scope amicited:write. Det hjælper ikke at prøve igen; forbind igen med skriveadgang.

Behandl en API-nøgle som en adgangskode

Enhver, der har en workspace-API-nøgle, kan køre alle serverens værktøjer mod dit workspaces data, også skrivninger. Foretræk OAuth, hold nøgler ude af delte repositories, og brug en miljøvariabel, hvor din klient understøtter det.

Kontrollér, at det virker#

Bed din agent om noget småt: “List my AmICited domains.” Den bør kalde list_domains og returnere dine domæner ved navn. Prøv derefter “Show my AI visibility for the last 30 days”, som bruger prompt_analytics.

Hvis forbindelsen afvises, siger beskeden som regel hvorfor:

  • Plan. “requires a Pro plan or above”: workspace-ejerens plan inkluderer ikke MCP.
  • Kreditter. Workspacets saldo er nul eller negativ. Fyld op, og prøv igen.
  • Hastighedsgrænse. Værktøjskald er begrænset pr. workspace pr. time: 120 på prøveperioden, 600 på Pro, 2.000 på Premium, ubegrænset på Enterprise. Beskeden siger, hvornår vinduet nulstilles. Opremsning af værktøjer og læsning af skills tæller ikke.

Relateret#