MCP-server

Forbind Claude, ChatGPT, Claude Code eller Cursor til din Affilyflow-konto – opsætning, login, de 23 værktøjer, prompts og grænser.

Se som Markdown

MCP-serveren lader din AI-assistent arbejde direkte med din Affilyflow-konto: finde programmer, læse butikkens regler, søge i varer, lave sporbare links og hente dine klik, salg, sider og saldo – i samtalen. Værktøjerne bruger de samme funktioner som dashboardet og REST-API'et, så tallene er de samme.

MCP-serveren er kun for affiliates.

Adressen

MCP-adresseTekst
https://app.affilyflow.com/api/mcp

Adressen er til en MCP-klient, der sender POST-forespørgsler. Åbner du den i en browser, får du 405 Method Not Allowed – det er forventet. Indsæt adressen som connector i din assistent.

Før du starter: du skal have en affiliate-konto, og du skal være tilmeldt de programmer, du vil lave links til. Assistenten kan ikke tilmelde dig.

Forbind Claude

  1. Åbn Customize → Connectors i Claude, og vælg Add custom connector.
  2. Giv forbindelsen navnet Affilyflow, og indsæt MCP-adressen.
  3. Vælg Connect. Log ind på din Affilyflow-konto, og godkend forbindelsen.
  4. Aktiver Affilyflow under Connectors i samtalen. Bed assistenten vise dine tilmeldte programmer.

På en teamkonto kan en ejer først skulle tilføje forbindelsen til organisationen. Se Anthropics vejledning: Get started with custom connectors.

Forbind ChatGPT

  1. Åbn ChatGPT på web. Find Developer mode under Settings → Apps → Advanced Settings, hvis funktionen er tilgængelig for din konto.
  2. Opret en custom app med navnet Affilyflow. Indsæt MCP-adressen, og vælg OAuth som godkendelse.
  3. Log ind på Affilyflow, og godkend forbindelsen. På en arbejdskonto kan din administrator skulle give adgang først.
  4. Vælg Affilyflow i samtalen. Bed ChatGPT vise de programmer, du er tilmeldt.

Forbind Claude Code

Kør kommandoen i din terminal:

TerminalShell
claude mcp add --transport http affilyflow https://app.affilyflow.com/api/mcp

Åbn derefter Claude Code, skriv /mcp, vælg Affilyflow, og gennemfør login i browseren. Du behøver ikke en API-nøgle. Fordi Claude Code kører på din egen computer, viser godkendelsessiden en advarsel – tillad kun, hvis du selv lige har startet forbindelsen.

Forbind Cursor og andre MCP-klienter

Klienter, der ikke kan logge ind med OAuth, bruger en API-nøgle. Opret den under AI og API i dashboardet (se REST-API), og sæt den ind i klientens konfiguration:

mcp.jsonJSON
{
  "mcpServers": {
    "affilyflow": {
      "url": "https://app.affilyflow.com/api/mcp",
      "headers": { "Authorization": "Bearer afk_DIN_NØGLE" }
    }
  }
}

Login og adgang

Claude, ChatGPT og Claude Code forbinder med login i stedet for en nøgle (OAuth 2.1 med PKCE). Assistenten sender dig til Affilyflows egen login- og godkendelsesside. Den viser appens navn og den adresse, du sendes tilbage til, så du kan se, at det er den rigtige app. Assistenten får en adgang til MCP-serveren – den får aldrig din adgangskode.

Assistenten kanAssistenten kan ikke
Læse programmer, regler, produkter, dine links, sites, klik, salg, saldo og udbetalingerTilmelde dig programmer
Oprette, omdøbe og arkivere linksSlette links eller sites
Tilføje og rette dine sitesSe eller ændre bank-, CPR-, skatte- eller adresseoplysninger eller din profil
Bede om udbetaling
  • En adgang gælder en time og fornyes automatisk. Fornyelsen gælder 60 dage og skiftes ved hver brug.
  • Adgangen fra et login virker kun på MCP-serveren – ikke på REST-API'et.
  • Under AI og API ser du dine forbundne apps og kan afbryde dem. API-nøgler tilbagekaldes samme sted. En afbrudt forbindelse virker ikke fra næste kald.

De data, du henter gennem assistenten, indgår hos den AI-tjeneste, du bruger. Vælg den konto og det arbejdsområde, du vil bruge til dine affiliateresultater.

Værktøjerne

Serveren har 23 værktøjer. De læsende ændrer intet. De skrivende laver, retter eller arkiverer kun dine egne links og sites – intet værktøj sletter.

Programmer og regler

VærktøjGør
search_programsSøger i alle åbne programmer – også dem, du ikke er tilmeldt – med provision, cookie, godkendelsesperiode, kanaler, regler, netværkets EPC og tilmeldingslink.
list_programsDe programmer, du er tilmeldt, med de gemte regler og butikkens retningslinjer.
get_programEt program i dybden: beskrivelse, retningslinjer ordret, regler i dag og kommende stramninger med dato, rabatkoder, materialer med færdig banner-HTML, topprodukter, netværkstal og dine egne tal.
check_complianceTjekker en planlagt promovering mod programmets målbare regler: kanal, rabatkode- og cashbacksider, betalt søgning, landingsside og reklamemarkering. Svarer ok, advarsel eller ikke tilladt pr. regel.
VærktøjGør
search_productsSøger i butikkernes varer med pris, lager, anslået provision og – for tilmeldte programmer – et færdigt link til varen.
create_linkOpretter eller genbruger et link med landingsside, sub-ID, kampagne, kanal, UTM, navn, HTML-kode og QR-kode. Skrivende.
create_links_batchOp til 50 links i et kald med et resultat pr. link. Skrivende.
list_linksDine links, nyeste først, eventuelt med tal pr. link.
get_linkEt link med tal, de sider det virker på, programmets status og reglerne i dag.
update_linkOmdøber et link, skifter landingsside eller site-etiket. Skrivende.
archive_linkSkjuler et link fra listen – det virker stadig. Skrivende.
restore_linkViser et arkiveret link igen. Skrivende.

Sites

VærktøjGør
get_sitesSites målt på klikkene med indtjening, side-sporingens dækning og forslag til sites, du kan tilføje (suggest_add).
get_pagesSiderne på dine sites med klik, salg, provision og udvikling.
list_websitesDine registrerede sites.
add_siteTilføjer et site. Tallene fra de klik, der allerede er kommet, følger med. Skrivende.
update_siteRetter domæne, navn, niche eller trafik – fx et domæne uden .dk. Skrivende.

Resultater

VærktøjGør
get_statsKlik, salg og provision for en periode – samlet eller pr. sub-ID, program, link, dag, site, side, kilde, enhed eller land, eventuelt sammenlignet med perioden før.
list_salesEnkelte salg med status, afvisningsårsag, godkendelsesdato, refusioner og klikket.
list_clicksEnkelte klik med side, kilde, enhed, land og de salg, klikket førte til.

Konto og udbetaling

VærktøjGør
get_accountDin konto, kvote for nye links og genveje til dashboardet.
get_balanceSaldo, næste udbetalingsdag og hvad der mangler. Kun læsning.
list_payoutsDine udbetalinger med afregningsbilag. Kun læsning.

Parametre og svar er de samme som i REST-API'et. Hvert værktøj svarer med struktureret data og den samme JSON som tekst. create_link og get_link med include_qr sender QR-koden som et billede.

Prompts

I Claude og Claude Code (og andre klienter, der understøtter prompts) findes fire færdige arbejdsgange:

PromptGørArgumenter
monthly_reportMånedsrapport med hovedtal, bedste programmer og sider, afviste salg og næste udbetaling.month (ÅÅÅÅ-MM, standard: sidste måned)
find_programs_for_my_nicheFinder de bedste åbne programmer til din niche og forklarer reglerne.niche, channel
optimize_linksGennemgår links, sider og side-sporing og foreslår forbedringer.–
build_product_linksFinder varer og laver links til dem i et kald.query (påkrævet), store, sub_id, count (standard 10, højst 50)

ChatGPT bruger ikke prompts – værktøjerne virker uden.

Hvad assistenten får at vide

Serveren giver assistenten en kort vejledning med: hvordan Affilyflow virker, en typisk arbejdsgang, at butikkens regler og retningslinjer skal følges, at en rabatkode ikke giver provision alene, at reklame skal markeres efter markedsføringsloven, at beløb er i kroner uden moms, og at datoer er i dansk tid. Assistenten afgør selv, hvordan den bruger det – tjek vigtige tal i dashboardet.

Prøv det

  • "Find de 10 sofaer, jeg tjener mest på hos Nordlys Bolig, og lav links til dem med sub-ID artikel-sofaer-okt. Tjek programmets regler først, og giv mig HTML-koden til mit site."
  • "Jeg vil lave en TikTok-video og køre Google Ads på generiske søgeord for et af mine programmer. Må jeg det? Vis butikkens retningslinjer, og sig hvis reglerne ændrer sig snart."
  • "Lav en rapport for sidste måned sammenlignet med måneden før: bedste programmer, sider og kilder, afviste salg med årsag og hvornår jeg får min næste udbetaling."
  • "Tilføj de sites, der sender mig klik."

Grænser

GrænseVærdi
Kald pr. minut120 pr. API-nøgle eller forbindelse
Skrivende kald pr. minut60 pr. API-nøgle eller forbindelse
Nye links500 pr. døgn pr. konto. Et genbrugt identisk link tæller ikke.
Links pr. batch50

Fejl

Et værktøj, der fejler, svarer med en fejl og en kode, som assistenten kan reagere på, fx:

KodeBetyder
not_joinedDu er ikke tilmeldt programmet. Tilmeld dig i dashboardet, og prøv igen.
channel_not_allowedKanalen er ikke tilladt i programmet.
landing_page_other_hostLandingssiden ligger ikke på butikkens domæne.
immutable_fieldSub-ID, kampagne og kanal kan ikke ændres på et eksisterende link. Lav et nyt, eller brug ?sid=.
daily_link_limit500 nye links det seneste døgn.
invalid_domain, duplicate_domainDomænet er ugyldigt eller findes allerede på et af dine sites.
rate_limitedFor mange kald. Vent lidt.

Den fulde liste står under REST-API → Fejlkoder.

Får du 401, er adgangen udløbet eller afbrudt: forbind assistenten igen, eller tjek at API-nøglen ikke er tilbagekaldt.

Til dig, der bygger en klient

  • Transport: Streamable HTTP uden sessioner. Hver POST er selvstændig, og der er ingen SSE-strøm på GET.
  • Protokol: serveren taler både 2025-11-25, 2025-06-18, 2025-03-26 og 2024-11-05 (med initialize) og den statsløse 2026-07-28 (med server/discover, version og klientkapabiliteter i params._meta og headerne MCP-Protocol-Version, Mcp-Method og Mcp-Name).
  • Adgang: Authorization: Bearer afk_… (API-nøgle) eller et OAuth-adgangstoken. Uden gyldig adgang svarer serveren 401 med WWW-Authenticate: Bearer resource_metadata="…", som starter login i klienten.

OAuth-adresser (Affilyflow er selv autorisationsserver):

AdresseFormål
/.well-known/oauth-protected-resource/api/mcpRessourcens metadata (RFC 9728).
/.well-known/oauth-authorization-serverAutorisationsserverens metadata (RFC 8414).
/oauth/authorizeLogin og godkendelse.
/oauth/tokenUdveksling af kode og fornyelse (authorization_code, refresh_token).
/oauth/registerDynamisk klientregistrering.
/oauth/revokeTilbagekald et token.

PKCE med S256 er påkrævet, scope er affiliate (plus offline_access for fornyelse), og tokenet bindes til ressourcen https://app.affilyflow.com/api/mcp. Klienter kan identificere sig med et Client ID Metadata Document (en URL som client_id) eller med dynamisk registrering. Redirect-adresser skal være https eller loopback.

Kald et værktøj med en API-nøgleShell
curl -X POST https://app.affilyflow.com/api/mcp \
  -H "Authorization: Bearer $AFFILYFLOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_stats","arguments":{"group_by":"program","compare":true}}}'

Mangler du noget?

Skriv til os – vi svarer hurtigt, og siden bliver rettet.

Kontakt support