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.
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
https://app.affilyflow.com/api/mcpAdressen 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
- Åbn Customize → Connectors i Claude, og vælg Add custom connector.
- Giv forbindelsen navnet Affilyflow, og indsæt MCP-adressen.
- Vælg Connect. Log ind på din Affilyflow-konto, og godkend forbindelsen.
- 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
- Åbn ChatGPT på web. Find Developer mode under Settings → Apps → Advanced Settings, hvis funktionen er tilgængelig for din konto.
- Opret en custom app med navnet Affilyflow. Indsæt MCP-adressen, og vælg OAuth som godkendelse.
- Log ind på Affilyflow, og godkend forbindelsen. På en arbejdskonto kan din administrator skulle give adgang først.
- Vælg Affilyflow i samtalen. Bed ChatGPT vise de programmer, du er tilmeldt.
Forbind Claude Code
Kør kommandoen i din terminal:
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:
{
"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 kan | Assistenten kan ikke |
|---|---|
| Læse programmer, regler, produkter, dine links, sites, klik, salg, saldo og udbetalinger | Tilmelde dig programmer |
| Oprette, omdøbe og arkivere links | Slette links eller sites |
| Tilføje og rette dine sites | Se 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øj | Gør |
|---|---|
search_programs | Søger i alle åbne programmer – også dem, du ikke er tilmeldt – med provision, cookie, godkendelsesperiode, kanaler, regler, netværkets EPC og tilmeldingslink. |
list_programs | De programmer, du er tilmeldt, med de gemte regler og butikkens retningslinjer. |
get_program | Et 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_compliance | Tjekker 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. |
Produkter og links
| Værktøj | Gør |
|---|---|
search_products | Søger i butikkernes varer med pris, lager, anslået provision og – for tilmeldte programmer – et færdigt link til varen. |
create_link | Opretter eller genbruger et link med landingsside, sub-ID, kampagne, kanal, UTM, navn, HTML-kode og QR-kode. Skrivende. |
create_links_batch | Op til 50 links i et kald med et resultat pr. link. Skrivende. |
list_links | Dine links, nyeste først, eventuelt med tal pr. link. |
get_link | Et link med tal, de sider det virker på, programmets status og reglerne i dag. |
update_link | Omdøber et link, skifter landingsside eller site-etiket. Skrivende. |
archive_link | Skjuler et link fra listen – det virker stadig. Skrivende. |
restore_link | Viser et arkiveret link igen. Skrivende. |
Sites
| Værktøj | Gør |
|---|---|
get_sites | Sites målt på klikkene med indtjening, side-sporingens dækning og forslag til sites, du kan tilføje (suggest_add). |
get_pages | Siderne på dine sites med klik, salg, provision og udvikling. |
list_websites | Dine registrerede sites. |
add_site | Tilføjer et site. Tallene fra de klik, der allerede er kommet, følger med. Skrivende. |
update_site | Retter domæne, navn, niche eller trafik – fx et domæne uden .dk. Skrivende. |
Resultater
| Værktøj | Gør |
|---|---|
get_stats | Klik, 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_sales | Enkelte salg med status, afvisningsårsag, godkendelsesdato, refusioner og klikket. |
list_clicks | Enkelte klik med side, kilde, enhed, land og de salg, klikket førte til. |
Konto og udbetaling
| Værktøj | Gør |
|---|---|
get_account | Din konto, kvote for nye links og genveje til dashboardet. |
get_balance | Saldo, næste udbetalingsdag og hvad der mangler. Kun læsning. |
list_payouts | Dine 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:
| Prompt | Gør | Argumenter |
|---|---|---|
monthly_report | Månedsrapport med hovedtal, bedste programmer og sider, afviste salg og næste udbetaling. | month (ÅÅÅÅ-MM, standard: sidste måned) |
find_programs_for_my_niche | Finder de bedste åbne programmer til din niche og forklarer reglerne. | niche, channel |
optimize_links | Gennemgår links, sider og side-sporing og foreslår forbedringer. | – |
build_product_links | Finder 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ænse | Værdi |
|---|---|
| Kald pr. minut | 120 pr. API-nøgle eller forbindelse |
| Skrivende kald pr. minut | 60 pr. API-nøgle eller forbindelse |
| Nye links | 500 pr. døgn pr. konto. Et genbrugt identisk link tæller ikke. |
| Links pr. batch | 50 |
Fejl
Et værktøj, der fejler, svarer med en fejl og en kode, som assistenten kan reagere på, fx:
| Kode | Betyder |
|---|---|
not_joined | Du er ikke tilmeldt programmet. Tilmeld dig i dashboardet, og prøv igen. |
channel_not_allowed | Kanalen er ikke tilladt i programmet. |
landing_page_other_host | Landingssiden ligger ikke på butikkens domæne. |
immutable_field | Sub-ID, kampagne og kanal kan ikke ændres på et eksisterende link. Lav et nyt, eller brug ?sid=. |
daily_link_limit | 500 nye links det seneste døgn. |
invalid_domain, duplicate_domain | Domænet er ugyldigt eller findes allerede på et af dine sites. |
rate_limited | For 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-26og2024-11-05(medinitialize) og den statsløse2026-07-28(medserver/discover, version og klientkapabiliteter iparams._metaog headerneMCP-Protocol-Version,Mcp-MethodogMcp-Name). - Adgang:
Authorization: Bearer afk_…(API-nøgle) eller et OAuth-adgangstoken. Uden gyldig adgang svarer serveren 401 medWWW-Authenticate: Bearer resource_metadata="…", som starter login i klienten.
OAuth-adresser (Affilyflow er selv autorisationsserver):
| Adresse | Formål |
|---|---|
/.well-known/oauth-protected-resource/api/mcp | Ressourcens metadata (RFC 9728). |
/.well-known/oauth-authorization-server | Autorisationsserverens metadata (RFC 8414). |
/oauth/authorize | Login og godkendelse. |
/oauth/token | Udveksling af kode og fornyelse (authorization_code, refresh_token). |
/oauth/register | Dynamisk klientregistrering. |
/oauth/revoke | Tilbagekald 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.
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.