Godkend en MCP-klient med OAuth

Trin-for-trin-guide til godkendelsesskærmen i Funnelfeedr, som vises, når du forbinder Claude, ChatGPT eller en anden MCP-klient, og hvad hver del af den betyder

Når du tilføjer Funnelfeedr i en MCP-klient, kan klienten ikke bare begynde at læse dine data. Den skal først godkendes af dig. Det sker via OAuth, den samme slags "Giv adgang"-flow, som du kender fra, når du forbinder apps til Google eller Microsoft.

Denne guide forklarer, hvad der sker i flowet, hvad godkendelsesskærmen i Funnelfeedr viser, og hvordan du træffer den rigtige beslutning på den.

Flowet i fem trin

Du tilføjer serveren i klienten. Du indsætter https://mcp.funnelfeedr.com/mcp i MCP-klienten og klikker på Connect (eller det tilsvarende i klienten).
Browseren åbner Funnelfeedr. Klienten sender dig til api.funnelfeedr.com, som videresender dig til godkendelsesskærmen på app.funnelfeedr.com. Hvis du ikke allerede er logget ind, logger du ind først. Din oprindelige anmodning bliver gemt, så du lander på godkendelsesskærmen efter login.
Du gennemgår godkendelsesskærmen. Den viser, hvilken applikation der spørger, hvad den vil gøre, og hvilken Funnelfeedr-bruger og hvilken konto den vil handle som. Hvis du tilhører flere konti, vælger du her, hvilken den skal forbindes til. Hvis du allerede har godkendt alt, hvad klienten beder om, og kun har én konto, springes dette trin over, og godkendelsen sker af sig selv.
Du klikker på Giv adgang eller Annullér.
Du sendes tilbage til klienten. Klienten modtager en token, og forbindelsen er klar. Du kan med det samme begynde at spørge assistenten om dine Funnelfeedr-data.

Hele flowet tager normalt et godt stykke under et minut. Selve anmodningen er gyldig i 10 minutter. Hvis du lader godkendelsesskærmen stå åben længere end det, udløber den, og du skal starte forfra fra klienten.

Sådan læser du godkendelsesskærmen

Hvem der spørger

Øverst på skærmen identificeres applikationen. Der er to tilfælde:

Bekræftet applikation. Skærmen viser et skjoldikon og et værtsnavn, for eksempel claude.ai. Det betyder, at applikationen identificerede sig med et offentligt identitetsdokument på den adresse, og at Funnelfeedr hentede og validerede det. Værtsnavnet er det, der faktisk blev bekræftet. Hvis applikationen også oplyser et visningsnavn, vises det som Kalder sig ”…” nedenunder, fordi det navn vælges af applikationen og ikke er noget, Funnelfeedr kan kontrollere.

Ubekræftet applikation. Skærmen viser et advarselsikon, overskriften Ubekræftet applikation og en gul advarselsboks. Det betyder, at applikationen registrerede sig hos Funnelfeedr på stedet uden en identitet, der kan bekræftes. Nogle legitime klienter fungerer stadig sådan. Fortsæt kun hvis du selv startede forbindelsen, for et øjeblik siden, fra en klient, du stoler på. Hvis skærmen dukker op, uden at du lige har forsøgt at forbinde noget, klikker du på Annullér.

Hvad den vil gøre

Under identiteten er der en liste over de rettigheder (scopes), der anmodes om, én linje pr. scope. Linjerne vises på engelsk. Funnelfeedr har tre:

Scope	Linjen på skærmen	Hvad det omfatter
Læse (`mcp:read`)	Read your organizations, contacts, lists, saved searches and knowledge base.	Alle læseværktøjer
Skrive (`mcp:write`)	Create lists, saved searches, ideal customer profiles and accounts, and add organizations and contacts to lists.	Oprette lister, tilføje og fjerne organisationer og kontakter på lister, gemme søgninger, oprette ideelle kundeprofiler og oprette konti
Afsløre (`mcp:spend`)	Reveal contact email addresses and phone numbers, spending this account's credits.	Prissætte og afsløre kontaktoplysninger

Skærmen viser præcis, hvad klienten bad om, og du godkender det hele eller annullerer; du kan ikke fjerne fluebenet ved et enkelt scope. En klient, der slet ikke beder om noget scope, får kun Læse. De tre er uafhængige af hinanden: Skrive giver ikke ret til at bruge kreditter, og Afsløre giver ikke ret til at redigere. En forbindelse uden Afsløre ser slet ikke afsløringsværktøjerne, og kontaktoplysninger forbliver maskerede præcis som før.

Der findes ingen andre scopes. Uanset hvad du godkender her, kan en MCP-klient aldrig pushe til dit CRM, sende e-mail, ringe op, købe kreditter eller skifte plan, og den kan ikke slette andet end at fjerne poster fra dine lister.

At godkende Afsløre er at godkende, at der bruges kreditter. Det lader assistenten bruge reveal_contacts, som trækker kreditter til kontoens normale priser for afsløring. Det er alligevel ingen blankocheck: assistenten skal først prissætte afsløringen med det gratis værktøj quote_reveal og vise dig den præcise pris, afsløringsværktøjet er markeret som en handling, der koster penge, så din klient beder dig bekræfte, højst 25 kontakter kan afsløres pr. kald, og kontakter, som kontoen allerede har afsløret, er gratis. Se Reference for MCP-værktøjer.

Hvis du tidligere har forbundet denne applikation til den samme konto, er de scopes, den allerede har, markeret Allerede givet. At godkende igen lægger de nye scopes sammen med de gamle; intet bliver nogensinde fjernet.

Eksisterende forbindelser skal forbindes igen for at kunne afsløre. Scopet Afsløre er nyere end connectoren, så en forbindelse, der blev godkendt, før det fandtes, har det simpelthen ikke, og det kan ikke tilføjes bagefter. Fjern connectoren i klienten, og tilføj den igen (eller tilbagekald forbindelsen under Indstillinger → MCP-forbindelser, og forbind igen), og kontrollér, at Afsløre er blandt de scopes, der vises på godkendelsesskærmen.

Forbind til konto

Hvis du tilhører mere end én Funnelfeedr-konto, har skærmen vælgeren Forbind til konto med alle de konti, du er medlem af, forvalgt på den, du er logget ind i. Det, du vælger her, er den konto, assistenten læser og skriver i. Har du kun én konto, er der ingen vælger, og kontoen vises bare.

Valget er ikke endeligt. Du kan flytte forbindelsen senere under Indstillinger → MCP-forbindelser eller bede assistenten gøre det for dig. En forbindelse peger på én konto ad gangen, så at skifte konto flytter forbindelsen i stedet for at tilføje en ny.

Forbinder som

Denne linje viser den bruger, assistenten vil handle som, og kontoen, når der ikke er nogen vælger, for eksempel anna@example.com · Example AB. Assistenten får præcis den adgang, som denne bruger har i den konto, og ikke mere. Hvis din Funnelfeedr-rolle ikke tillader at redigere leads, kan assistenten heller ikke oprette lister, selv om Skrive-scopet er godkendt.

Sender dig tilbage til

Den præcise adresse, som klienten angav som returadresse. For Claude på nettet er det https://claude.ai/api/mcp/auth_callback; for Claude Code er det en localhost-adresse. Hvis den ikke ser ud til at have noget med den klient, du bruger, at gøre, så annullér.

Giv adgang eller Annullér

Giv adgang opretter forbindelsen og sender dig tilbage til klienten.
Annullér fortæller klienten, at du afviste. Intet gemmes i Funnelfeedr, og intet skal ryddes op.

Under alle omstændigheder kan du lukke browserfanen bagefter. Nogle klienter lukker den for dig.

Hvad der sker efter godkendelsen

Klienten får en kortlivet adgangstoken (gyldig i 60 minutter) og en refresh-token (gyldig i 30 dage). Den fornyer selv adgangstokenen; du mærker ikke, at det sker.
Så længe klienten bruges mindst én gang hver 30. dag, forbliver forbindelsen aktiv, uden at du skal gøre noget. Efter 30 dages inaktivitet sender klienten dig gennem godkendelsesflowet igen.
Forbindelsen vises under Indstillinger → MCP-forbindelser med applikationens navn, den konto, den bruger, de scopes, du gav, hvornår den blev oprettet, og hvornår den sidst blev brugt.

Tilbagekald adgang

Du kan tilbagekalde enhver forbindelse når som helst under Indstillinger → MCP-forbindelser. Klientens refresh-tokens holder op med at virke med det samme, og en assistent midt i en samtale mister adgangen inden for cirka to minutter, når serveren kontrollerer forbindelsen igen. Kontoadministratorer kan også se og tilbagekalde alle forbindelser i kontoen. Se Administrer MCP-forbindelser.

At slette connectoren inde i klienten tilbagekalder den ikke på Funnelfeedr-siden. Hvis du vil være sikker på, at tokens ikke virker længere, så tilbagekald dem i Funnelfeedr.

Sikkerhedsdetaljer

Til dig, der vil vide præcis, hvad der sker under motorhjelmen:

Flowet er OAuth 2.1 med PKCE (S256). Der er ingen klienthemmelighed; klienten beviser, at den startede anmodningen, ved at fremvise en kode, den genererede lokalt.
Funnelfeedr er både autorisationsserver (udsteder tokens) og ressourceserver (modtager dem). Tokens er bundet til https://mcp.funnelfeedr.com/mcp og accepteres ingen andre steder.
Klienter identificerer sig enten via et Client ID Metadata Document (et offentligt identitetsdokument på en HTTPS-adresse, vises som bekræftet værtsnavn) eller via Dynamic Client Registration (vises som ubekræftet).
De tokens, klienten har, identificerer dig. Hvert værktøjskald autoriseres mod din rolle og dine seats i det øjeblik, det sker, og hvert kald logges. Hvilken konto en anmodning kører i, læses fra den gemte forbindelse ved hver anmodning, og det er det, der gør, at en forbindelse kan flyttes mellem dine konti, uden at du forbinder igen. Den læses igen mindst hvert andet minut, hvilket er den ydre grænse for, hvor længe en tilbagekaldt eller flyttet forbindelse beholder sin gamle adgang.
Standardiserede discovery-dokumenter offentliggøres på https://mcp.funnelfeedr.com/.well-known/oauth-protected-resource/mcp og på autorisationsserverens /.well-known/oauth-authorization-server, så alle klienter, der følger standarden, selv kan finde endpoints.

Almindelige problemer

"Forbindelsesanmodningen er udløbet eller allerede brugt." Der er gået mere end 10 minutter, eller du genindlæste siden efter godkendelsen. Start forbindelsen igen fra klienten.

"Vi kunne ikke finde denne forbindelsesanmodning." Linket er ufuldstændigt eller blev afkortet, da det blev kopieret. Start forfra fra klienten.

Godkendelsesskærmen vises aldrig, og klienten melder en fejl. Kontrollér, at du har indtastet serveradressen præcis som https://mcp.funnelfeedr.com/mcp, og at intet på dit netværk (en virksomhedsproxy eller en firewall) blokerer api.funnelfeedr.com, app.funnelfeedr.com eller mcp.funnelfeedr.com.

Assistenten siger, at et værktøj kræver et scope, der ikke er givet. Fjern connectoren i klienten, og forbind igen. Det er klienten, der bestemmer, hvilke scopes der anmodes om, så kontrollér, at det, du har brug for, står på godkendelsesskærmen. Det er også sådan, du slår afsløring til på en forbindelse, der blev oprettet, før scopet Afsløre fandtes.

Flere tilfælde er beskrevet i Fejlfinding af MCP.