Godkjenn en MCP-klient med OAuth

Steg-for-steg-guide til godkjenningsskjermen i Funnelfeedr som vises når du kobler til Claude, ChatGPT eller en annen MCP-klient, og hva hver del av den betyr

Når du legger til Funnelfeedr i en MCP-klient, kan ikke klienten bare begynne å lese dataene dine. Den må først godkjennes av deg. Det skjer via OAuth, den samme typen "Gi tilgang"-flyt som du kjenner fra når du kobler apper til Google eller Microsoft.

Denne guiden forklarer hva som skjer i flyten, hva godkjenningsskjermen i Funnelfeedr viser og hvordan du tar riktig beslutning på den.

Flyten i fem steg

Du legger til serveren i klienten. Du limer inn https://mcp.funnelfeedr.com/mcp i MCP-klienten og klikker på Connect (eller det tilsvarende i klienten).
Nettleseren åpner Funnelfeedr. Klienten sender deg til api.funnelfeedr.com, som videresender deg til godkjenningsskjermen på app.funnelfeedr.com. Hvis du ikke allerede er logget inn, logger du inn først. Den opprinnelige forespørselen din blir tatt vare på, så du havner på godkjenningsskjermen etter innloggingen.
Du ser gjennom godkjenningsskjermen. Den viser hvilken applikasjon som spør, hva den vil gjøre og hvilken Funnelfeedr-bruker og hvilken konto den skal opptre som. Hvis du tilhører flere kontoer, velger du her hvilken den skal kobles til. Hvis du allerede har godkjent alt klienten ber om og bare har én konto, hoppes dette steget over og godkjenningen skjer av seg selv.
Du klikker på Gi tilgang eller Avbryt.
Du sendes tilbake til klienten. Klienten får en token, og tilkoblingen er klar. Du kan med en gang begynne å spørre assistenten om Funnelfeedr-dataene dine.

Hele flyten tar vanligvis godt under ett minutt. Selve forespørselen er gyldig i 10 minutter. Hvis du lar godkjenningsskjermen stå åpen lenger enn det, utløper den, og du må begynne på nytt fra klienten.

Slik leser du godkjenningsskjermen

Hvem som spør

Øverst på skjermen identifiseres applikasjonen. Det finnes to tilfeller:

Bekreftet applikasjon. Skjermen viser et skjoldikon og et vertsnavn, for eksempel claude.ai. Det betyr at applikasjonen identifiserte seg med et offentlig identitetsdokument på den adressen, og at Funnelfeedr hentet og validerte det. Vertsnavnet er det som faktisk ble bekreftet. Hvis applikasjonen også oppgir et visningsnavn, vises det som Kaller seg «…» under, fordi det navnet velges av applikasjonen og ikke er noe Funnelfeedr kan kontrollere.

Ubekreftet applikasjon. Skjermen viser et varselikon, overskriften Ubekreftet applikasjon og en gul varselboks. Det betyr at applikasjonen registrerte seg hos Funnelfeedr der og da, uten en identitet som kan bekreftes. Noen legitime klienter fungerer fortsatt slik. Fortsett bare hvis du selv startet tilkoblingen, nettopp, fra en klient du stoler på. Hvis skjermen dukker opp uten at du nettopp prøvde å koble til noe, klikker du på Avbryt.

Hva den vil gjøre

Under identiteten er det en liste over rettighetene (scopes) som blir bedt om, én linje per scope. Linjene vises på engelsk. Funnelfeedr har tre:

Scope	Linjen på skjermen	Hva det omfatter
Lese (`mcp:read`)	Read your organizations, contacts, lists, saved searches and knowledge base.	Alle leseverktøy
Skrive (`mcp:write`)	Create lists, saved searches, ideal customer profiles and accounts, and add organizations and contacts to lists.	Opprette lister, legge til og fjerne organisasjoner og kontakter i lister, lagre søk, opprette ideelle kundeprofiler og opprette kontoer
Avsløre (`mcp:spend`)	Reveal contact email addresses and phone numbers, spending this account's credits.	Prise og avsløre kontaktopplysninger

Skjermen viser nøyaktig hva klienten ba om, og du godkjenner alt eller avbryter; du kan ikke fjerne haken for ett enkelt scope. En klient som ikke ber om noe scope i det hele tatt, får bare Lese. De tre er uavhengige av hverandre: Skrive gir ikke rett til å bruke kreditter, og Avsløre gir ikke rett til å redigere. En tilkobling uten Avsløre ser ikke engang avsløringsverktøyene, og kontaktopplysninger forblir maskert akkurat som før.

Det finnes ingen andre scopes. Uansett hva du godkjenner her, kan en MCP-klient aldri pushe til CRM-et ditt, sende e-post, ringe, kjøpe kreditter eller endre plan, og den kan ikke slette noe annet enn å fjerne oppføringer fra listene dine.

Å godkjenne Avsløre er å godkjenne at kreditter brukes. Det lar assistenten bruke reveal_contacts, som trekker kreditter til kontoens vanlige priser for avsløring. Det er likevel ingen blankofullmakt: assistenten må først prise avsløringen med det gratis verktøyet quote_reveal og vise deg nøyaktig hva det koster, avsløringsverktøyet er merket som en handling som koster penger, så klienten ber deg bekrefte, høyst 25 kontakter kan avsløres per kall, og kontakter kontoen allerede har avslørt, er gratis. Se Referanse for MCP-verktøy.

Hvis du har koblet denne applikasjonen til samme konto tidligere, er scopes den allerede har, merket Allerede gitt. Å godkjenne på nytt slår sammen de nye scopes med de gamle; ingenting blir noen gang fjernet.

Eksisterende tilkoblinger må kobles til på nytt for å kunne avsløre. Scopet Avsløre er nyere enn connectoren, så en tilkobling som ble godkjent før det fantes, har det rett og slett ikke, og det kan ikke legges til i etterkant. Fjern connectoren i klienten og legg den til igjen (eller tilbakekall tilkoblingen under Innstillinger → MCP-tilkoblinger og koble til på nytt), og kontroller at Avsløre er blant scopes som vises på godkjenningsskjermen.

Koble til konto

Hvis du tilhører mer enn én Funnelfeedr-konto, har skjermen velgeren Koble til konto med alle kontoene du er medlem av, forhåndsvalgt på den du er logget inn i. Det du velger her, er kontoen assistenten leser og skriver i. Har du bare én konto, finnes det ingen velger, og kontoen vises bare.

Valget er ikke endelig. Du kan flytte tilkoblingen senere under Innstillinger → MCP-tilkoblinger, eller be assistenten gjøre det for deg. En tilkobling peker på én konto om gangen, så å bytte konto flytter tilkoblingen i stedet for å legge til en ny.

Kobler til som

Denne linjen viser brukeren assistenten skal opptre som, og kontoen når det ikke finnes noen velger, for eksempel anna@example.com · Example AB. Assistenten får nøyaktig den tilgangen denne brukeren har i den kontoen, ikke mer. Hvis Funnelfeedr-rollen din ikke tillater å redigere leads, kan assistenten heller ikke opprette lister, selv om Skrive-scopet er godkjent.

Sender deg tilbake til

Den nøyaktige adressen klienten oppga 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 ser ut til å ikke ha noe med klienten du bruker å gjøre, avbryter du.

Gi tilgang eller Avbryt

Gi tilgang oppretter tilkoblingen og sender deg tilbake til klienten.
Avbryt forteller klienten at du avslo. Ingenting lagres i Funnelfeedr, og ingenting må ryddes opp.

Uansett kan du lukke nettleserfanen etterpå. Noen klienter lukker den for deg.

Hva som skjer etter godkjenningen

Klienten får en kortlivet tilgangstoken (gyldig i 60 minutter) og en refresh-token (gyldig i 30 dager). Den fornyer tilgangstokenen selv; du merker ikke at det skjer.
Så lenge klienten brukes minst én gang hver 30. dag, forblir tilkoblingen aktiv uten at du trenger å gjøre noe. Etter 30 dager uten aktivitet sender klienten deg gjennom godkjenningsflyten igjen.
Tilkoblingen vises under Innstillinger → MCP-tilkoblinger med navnet på applikasjonen, kontoen den bruker, scopes du ga, når den ble opprettet og når den sist ble brukt.

Tilbakekalle tilgang

Du kan tilbakekalle hvilken som helst tilkobling når som helst under Innstillinger → MCP-tilkoblinger. Klientens refresh-tokens slutter å virke med en gang, og en assistent midt i en samtale mister tilgangen innen omtrent to minutter, når serveren kontrollerer tilkoblingen på nytt. Kontoadministratorer kan også se og tilbakekalle alle tilkoblinger i kontoen. Se Administrere MCP-tilkoblinger.

Å slette connectoren i klienten tilbakekaller den ikke på Funnelfeedr-siden. Hvis du vil være sikker på at tokenene ikke virker lenger, tilbakekaller du dem i Funnelfeedr.

Sikkerhetsdetaljer

For deg som vil vite nøyaktig hva som skjer under panseret:

Flyten er OAuth 2.1 med PKCE (S256). Det finnes ingen klienthemmelighet; klienten beviser at den startet forespørselen ved å vise frem en kode den genererte lokalt.
Funnelfeedr er både autorisasjonsserver (utsteder tokens) og ressursserver (tar imot dem). Tokens er bundet til https://mcp.funnelfeedr.com/mcp og godtas ingen andre steder.
Klienter identifiserer seg enten via et Client ID Metadata Document (et offentlig identitetsdokument på en HTTPS-adresse, vises som bekreftet vertsnavn) eller via Dynamic Client Registration (vises som ubekreftet).
Tokenene klienten har, identifiserer deg. Hvert verktøykall autoriseres mot rollen din og seatene dine i det øyeblikket det skjer, og hvert kall logges. Hvilken konto en forespørsel kjører i, leses fra den lagrede tilkoblingen ved hver forespørsel, og det er det som gjør at en tilkobling kan flyttes mellom kontoene dine uten at du kobler til på nytt. Den leses på nytt minst annethvert minutt, som er den ytre grensen for hvor lenge en tilbakekalt eller flyttet tilkobling beholder den gamle tilgangen.
Standardiserte oppdagelsesdokumenter publiseres på https://mcp.funnelfeedr.com/.well-known/oauth-protected-resource/mcp og på autorisasjonsserverens /.well-known/oauth-authorization-server, så alle klienter som følger standarden, finner endepunktene selv.

Vanlige problemer

"Tilkoblingsforespørselen er utløpt eller allerede brukt." Det har gått mer enn 10 minutter, eller du lastet inn siden på nytt etter at du godkjente. Start tilkoblingen på nytt fra klienten.

"Vi fant ikke denne tilkoblingsforespørselen." Lenken er ufullstendig eller ble kuttet da den ble kopiert. Begynn på nytt fra klienten.

Godkjenningsskjermen vises aldri, og klienten rapporterer en feil. Kontroller at du skrev inn serveradressen nøyaktig som https://mcp.funnelfeedr.com/mcp, og at ingenting i nettverket (en bedriftsproxy eller en brannmur) blokkerer api.funnelfeedr.com, app.funnelfeedr.com eller mcp.funnelfeedr.com.

Assistenten sier at et verktøy krever et scope som ikke er gitt. Fjern connectoren i klienten og koble til igjen. Det er klienten som bestemmer hvilke scopes det blir bedt om, så kontroller at det du trenger, står på godkjenningsskjermen. Det er også slik du slår på avsløring for en tilkobling som ble laget før scopet Avsløre fantes.

Flere tilfeller tas opp i Feilsøking for MCP.