Dokumentasjon

AI-agenter (MCP)

Koble til MCP-serveren

Koble Claude, Claude Code, ChatGPT, Cursor, VS Code eller Codex til AmICited-arbeidsområdet ditt over MCP. Én URL, OAuth-innlogging og en API-nøkkel som reserveløsning.

AmICited kjører en alltid tilgjengelig MCP-server (Model Context Protocol). Når AI-klienten din er koblet til, kan den lese synlighetsdataene dine, kjøre rapporter og, med skrivetilgang, legge til prompts, generere artikler eller logge annotasjoner, alt fra en vanlig samtale. Hver funksjon i dashbordet leveres også som et MCP-verktøy, så det finnes ingenting du kan gjøre i appen som en agent ikke kan.

Før du starter#

  • En plan som inkluderer MCP. MCP er tilgjengelig i 7-dagers prøveperioden og på Pro, Premium og Enterprise. Starter-arbeidsområder kan se server-URL-en, men tilkoblinger avvises til planen oppgraderes. Se planer og grenser.
  • Editor-rettigheter eller høyere i arbeidsområdet. Siden MCP ber medlemmer uten dem om å spørre en eier eller administrator av arbeidsområdet.
  • En positiv kreditsaldo. Lesing over MCP er gratis, men endepunktet sjekker at arbeidsområdet har kreditter før det svarer. Se kreditter.

Server-URL-en#

Det finnes én URL for alle:

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

Arbeidsområdet står ikke i URL-en. Det kommer fra legitimasjonen din: med OAuth velger du arbeidsområdet på samtykkeskjermen, og en API-nøkkel tilhører allerede ett arbeidsområde. Du kan også kopiere URL-en fra siden MCP i appen, som viser den med en Copy URL-knapp og de samme instruksjonene per klient som nedenfor. Transporten er streamable HTTP.

Koble til klienten din#

Velg klienten din. Hver fane starter med den anbefalte OAuth-innloggingen og slutter med alternativet med API-nøkkel.

Claude (web og Desktop)

Koblinger du legger til på claude.ai er også tilgjengelige i Claude Desktop-appen.

  1. Åpne Claudes koblingsinnstillinger.
  2. Klikk +, deretter Add custom connector.
  3. Lim inn https://api.flowhunt.io/mcp/amicited og klikk Add.
  4. Klikk Connect på den nye koblingen og godkjenn tilgang i nettleservinduet som åpnes. Velg arbeidsområdet ditt på samtykkeskjermen.

I en chat åpner du verktøymenyen og sørger for at AmICited-koblingen er aktivert.

Alternativ med API-nøkkel (Claude Desktop-konfigurasjonsfil). Legg dette under mcpServers i ~/Library/Application Support/Claude/claude_desktop_config.json på macOS, og start deretter Claude Desktop på nytt:

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

Claude Code

Registrer serveren én gang fra terminalen din:

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

Kjør deretter /mcp i Claude Code, velg Authenticate, og godkjenn tilgang i nettleservinduet som åpnes.

Alternativ med API-nøkkel. Legg serveren under nøkkelen mcpServers på toppnivå i ~/.claude.json og start Claude Code på nytt:

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

ChatGPT

Egendefinerte MCP-koblinger krever Developer mode, som er tilgjengelig på betalte ChatGPT-planer (Plus, Pro, Team, Enterprise). I Business-, Enterprise- og Edu-arbeidsområder kan en administrator måtte aktivere det for deg.

  1. Slå på Developer mode som beskrevet i OpenAIs dokumentasjon om koblinger.
  2. Åpne Settings i ChatGPT, deretter Apps & Connectors.
  3. Legg til en egendefinert kobling og lim inn https://api.flowhunt.io/mcp/amicited.
  4. Godkjenn tilgang i nettleservinduet som åpnes.

Alternativ med API-nøkkel. Velg API-nøkkelautentisering i stedet ved trinn 4 og lim inn API-nøkkelen til arbeidsområdet ditt. Lagre koblingen, og aktiver den deretter i en ny chat.

Cursor

På appens MCP-side velger du Cursor og klikker Add to Cursor. Cursor installerer serveren og kjører innloggingen for deg.

Hvis knappen ikke åpner Cursor, legg til serveren manuelt i Cursors innstillinger under MCP, eller rediger ~/.cursor/mcp.json (eller en .cursor/mcp.json per prosjekt):

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

Cursor åpner en nettleser for innlogging første gang den kobler til. Sett chatten til Agent-modus for å bruke verktøyene.

Alternativ med API-nøkkel. Legg til en header i den samme oppføringen:

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

VS Code

VS Code bruker serveren gjennom GitHub Copilot i Agent-modus, så Copilot må være aktivert.

På appens MCP-side velger du VS Code og klikker Add to VS Code. VS Code installerer serveren og kjører innloggingen for deg.

For å legge den til manuelt åpner du kommandopaletten, kjører MCP: Open User Configuration, og legger serveren under servers:

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

Alternativ med API-nøkkel. Legg til "headers": { "Authorization": "Bearer <your-workspace-api-key>" } i oppføringen. Du kan også kjøre MCP: Add Server…, velge HTTP (HTTP or Server-Sent Events), lime inn URL-en og legge til Authorization-headeren når du blir bedt om det.

Codex

Codex kobler til som en vanlig ekstern MCP-klient. Legg til serveren, og logg deretter inn:

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

Eller rediger ~/.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"

Alternativ med API-nøkkel. Legg nøkkelen i en miljøvariabel og pek Codex til den:

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

Codex-kjøringer med strenge godkjenningsinnstillinger når fortsatt hvert skrivebeskyttet verktøy gjennom read_tool. Se toolsets og verktøy.

OAuth eller API-nøkkel#

OAuth 2.1 (anbefalt)API-nøkkel for arbeidsområdet (reserve)
OppsettLim inn URL-en, godkjenn i nettleserenLim inn URL-en pluss en Authorization: Bearer-header
ArbeidsområdeVelges på samtykkeskjermenFastsatt av nøkkelen
Tillatelseramicited:read for å koble til og lese; amicited:write trengs også for skrivingFull tilgang til arbeidsområdet
TilbakekallingConnected clients → Revoke på MCP-sidenSlett nøkkelen eller la den utløpe

OAuth er den bedre standarden: det er ingen hemmelighet å lime inn i en konfigurasjonsfil, hver klient vises med navn på siden MCP under Connected clients, og du kan tilbakekalle én uten å røre de andre. Et skrivebeskyttet OAuth-token kan liste og lese alt, men ethvert verktøy som oppretter, redigerer eller sletter, vil avvise med en melding som nevner scopet amicited:write. Å prøve på nytt hjelper ikke; koble til på nytt med skrivetilgang.

Behandle en API-nøkkel som et passord

Alle som har en API-nøkkel til arbeidsområdet, kan kjøre alle verktøy på serveren mot dataene i arbeidsområdet ditt, inkludert skriving. Foretrekk OAuth, hold nøkler unna delte repositorier, og bruk en miljøvariabel der klienten din støtter det.

Sjekk at det fungerer#

Spør agenten din om noe lite: «List my AmICited domains.» Den bør kalle list_domains og returnere domenene dine ved navn. Prøv deretter «Show my AI visibility for the last 30 days», som bruker prompt_analytics.

Hvis tilkoblingen avvises, sier meldingen vanligvis hvorfor:

  • Plan. «requires a Pro plan or above»: planen til eieren av arbeidsområdet inkluderer ikke MCP.
  • Kreditter. Arbeidsområdets saldo er null eller negativ. Fyll på og prøv igjen.
  • Rate limit. Verktøykall er begrenset per arbeidsområde per time: 120 i prøveperioden, 600 på Pro, 2 000 på Premium, ubegrenset på Enterprise. Meldingen sier når vinduet nullstilles. Å liste verktøy og lese skills teller ikke.

Relatert#