MCP-asiakasohjelman valtuuttaminen OAuthilla

Vaiheittainen opas Funnelfeedrin hyväksyntänäkymään, joka avautuu, kun yhdistät Clauden, ChatGPT:n tai muun MCP-asiakasohjelman, ja siihen, mitä näkymän eri osat tarkoittavat

Kun lisäät Funnelfeedrin MCP-asiakasohjelmaan, ohjelma ei voi noin vain alkaa lukea tietojasi. Sinun on ensin valtuutettava se. Tämä tapahtuu OAuthin kautta, samanlaisella "Salli käyttö" -tyyppisellä kululla, jonka tunnet sovellusten yhdistämisestä Googleen tai Microsoftiin.

Tämä opas kertoo, mitä kulun aikana tapahtuu, mitä Funnelfeedrin hyväksyntänäkymä näyttää ja miten teet siinä oikean päätöksen.

Kulku viidessä vaiheessa

Lisäät palvelimen asiakasohjelmaan. Liität osoitteen https://mcp.funnelfeedr.com/mcp MCP-asiakasohjelmaan ja napsautat Connect (tai asiakasohjelman vastaavaa painiketta).
Selain avaa Funnelfeedrin. Asiakasohjelma ohjaa sinut osoitteeseen api.funnelfeedr.com, joka ohjaa sinut edelleen hyväksyntänäkymään osoitteessa app.funnelfeedr.com. Jos et ole vielä kirjautunut sisään, kirjaudut ensin. Alkuperäinen pyyntösi säilyy, joten päädyt kirjautumisen jälkeen hyväksyntänäkymään.
Tarkistat hyväksyntänäkymän. Siinä näkyy, mikä sovellus pyytää käyttöä, mitä se haluaa tehdä ja minkä Funnelfeedr-käyttäjän ja minkä tilin nimissä se toimii. Jos kuulut useaan tiliin, valitset tässä, mihin tiliin yhteys muodostetaan. Jos olet jo hyväksynyt kaiken, mitä asiakasohjelma pyytää, ja sinulla on vain yksi tili, tämä vaihe ohitetaan ja hyväksyntä tapahtuu itsestään.
Napsautat Salli käyttö tai Peruuta.
Sinut ohjataan takaisin asiakasohjelmaan. Asiakasohjelma saa tokenin, ja yhteys on valmis. Voit heti alkaa kysyä avustajalta Funnelfeedr-tiedoistasi.

Koko kulku kestää yleensä selvästi alle minuutin. Itse pyyntö on voimassa 10 minuuttia. Jos jätät hyväksyntänäkymän auki tätä pidemmäksi aikaa, pyyntö vanhenee ja sinun on aloitettava alusta asiakasohjelmasta.

Hyväksyntänäkymän lukeminen

Kuka pyytää

Näkymän yläosassa tunnistetaan sovellus. Vaihtoehtoja on kaksi:

Vahvistettu sovellus. Näkymässä on kilpikuvake ja isäntänimi, esimerkiksi claude.ai. Se tarkoittaa, että sovellus tunnisti itsensä kyseisessä osoitteessa olevalla julkisella tunnistusasiakirjalla ja että Funnelfeedr haki ja tarkisti sen. Isäntänimi on se osa, joka todella vahvistettiin. Jos sovellus ilmoittaa myös näyttönimen, se näkyy alla muodossa Kutsuu itseään nimellä ”…”, koska sovellus valitsee nimen itse eikä Funnelfeedr voi tarkistaa sitä.

Vahvistamaton sovellus. Näkymässä on varoituskuvake, otsikko Vahvistamaton sovellus ja keltainen varoitusruutu. Se tarkoittaa, että sovellus rekisteröi itsensä Funnelfeedriin saman tien ilman vahvistettavaa identiteettiä. Jotkin luotettavat asiakasohjelmat toimivat edelleen näin. Jatka vain, jos aloitit yhteyden itse, hetki sitten, asiakasohjelmasta, johon luotat. Jos näkymä tulee esiin, vaikka et juuri yrittänyt yhdistää mitään, napsauta Peruuta.

Mitä se haluaa tehdä

Identiteetin alla on luettelo pyydetyistä oikeuksista (scopes), yksi rivi oikeutta kohden. Rivit näytetään englanniksi. Funnelfeedrissä on kolme oikeutta:

Oikeus	Rivi näkymässä	Mitä se kattaa
Luku (`mcp:read`)	Read your organizations, contacts, lists, saved searches and knowledge base.	Kaikki lukutyökalut
Kirjoitus (`mcp:write`)	Create lists, saved searches, ideal customer profiles and accounts, and add organizations and contacts to lists.	Listojen luominen, organisaatioiden ja yhteyshenkilöiden lisääminen listoille ja poistaminen niiltä, hakujen tallentaminen, ihanneasiakasprofiilien luominen ja tilien luominen
Paljastus (`mcp:spend`)	Reveal contact email addresses and phone numbers, spending this account's credits.	Yhteystietojen hinnoittelu ja paljastaminen

Näkymä näyttää täsmälleen sen, mitä asiakasohjelma pyysi, ja joko hyväksyt kaiken tai peruutat; yksittäistä oikeutta ei voi poistaa valinnoista. Asiakasohjelma, joka ei pyydä mitään oikeutta, saa vain Luku-oikeuden. Oikeudet ovat toisistaan riippumattomia: Kirjoitus ei anna oikeutta käyttää krediittejä, eikä Paljastus anna oikeutta muokata. Yhteys, jolla ei ole Paljastus-oikeutta, ei edes näe paljastustyökaluja, ja yhteystiedot pysyvät peitettyinä aivan kuten ennenkin.

Muita oikeuksia ei ole. Hyväksytpä mitä tahansa, MCP-asiakasohjelma ei voi koskaan viedä tietoja CRM:ään, lähettää sähköpostia, soittaa puheluita, ostaa krediittejä tai vaihtaa tilaustasi, eikä se voi poistaa mitään muuta kuin rivejä listoiltasi.

Paljastus-oikeuden hyväksyminen tarkoittaa krediittien käytön hyväksymistä. Sen avulla avustaja voi käyttää työkalua reveal_contacts, joka kuluttaa krediittejä tilisi tavallisilla paljastushinnoilla. Se ei silti ole avoin valtakirja: avustajan on ensin hinnoiteltava paljastus maksuttomalla quote_reveal-työkalulla ja näytettävä sinulle tarkka hinta, paljastustyökalu on merkitty kuluja aiheuttavaksi toiminnoksi, joten asiakasohjelma pyytää sinulta vahvistuksen, yhdellä kutsulla voi paljastaa enintään 25 yhteyshenkilöä, ja tilisi jo paljastamat yhteyshenkilöt ovat maksuttomia. Katso MCP-työkalujen hakuteos.

Jos olet aiemmin yhdistänyt tämän sovelluksen samaan tiliin, sillä jo olevat oikeudet on merkitty tekstillä Jo myönnetty. Uusi hyväksyntä yhdistää uudet oikeudet vanhoihin; mitään ei koskaan poisteta.

Olemassa olevat yhteydet on yhdistettävä uudelleen, jotta paljastaminen onnistuu. Paljastus-oikeus on connectoria uudempi, joten yhteydellä, joka hyväksyttiin ennen oikeuden käyttöönottoa, sitä ei yksinkertaisesti ole, eikä sitä voi lisätä jälkikäteen. Poista connector asiakasohjelmasta ja lisää se uudelleen (tai peru yhteys kohdassa Asetukset → MCP-yhteydet ja yhdistä uudelleen) ja tarkista, että Paljastus on hyväksyntänäkymässä näkyvien oikeuksien joukossa.

Yhdistä tiliin

Jos kuulut useampaan kuin yhteen Funnelfeedr-tiliin, näkymässä on valitsin Yhdistä tiliin, jossa on kaikki tilit, joiden jäsen olet. Oletuksena on valittuna tili, johon olet kirjautunut. Tässä valitsemasi tili on se, jossa avustaja lukee ja kirjoittaa. Jos sinulla on vain yksi tili, valitsinta ei ole, vaan tili vain näytetään.

Valinta ei ole lopullinen. Voit siirtää yhteyden myöhemmin kohdassa Asetukset → MCP-yhteydet tai pyytää avustajaa tekemään sen puolestasi. Yhteys osoittaa yhteen tiliin kerrallaan, joten tilin vaihtaminen siirtää yhteyden eikä lisää toista.

Yhdistetään käyttäjänä

Tämä rivi näyttää käyttäjän, jonka nimissä avustaja toimii, ja tilin silloin, kun valitsinta ei ole, esimerkiksi anna@example.com · Example AB. Avustaja saa täsmälleen samat käyttöoikeudet kuin tällä käyttäjällä on kyseisessä tilissä, ei enempää. Jos Funnelfeedr-roolisi ei salli liidien muokkaamista, avustaja ei voi myöskään luoda listoja, vaikka Kirjoitus-oikeus olisi hyväksytty.

Palauttaa sinut osoitteeseen

Tarkka osoite, jonka asiakasohjelma antoi paluuosoitteeksi. Clauden verkkoversiossa se on https://claude.ai/api/mcp/auth_callback; Claude Codessa se on localhost-osoite. Jos osoite ei näytä liittyvän käyttämääsi asiakasohjelmaan, peruuta.

Salli käyttö vai Peruuta

Salli käyttö luo yhteyden ja palauttaa sinut asiakasohjelmaan.
Peruuta kertoo asiakasohjelmalle, että kieltäydyit. Funnelfeedriin ei tallenneta mitään, eikä mitään tarvitse siivota.

Kummassakin tapauksessa voit sulkea selaimen välilehden jälkikäteen. Jotkin asiakasohjelmat sulkevat sen puolestasi.

Mitä hyväksynnän jälkeen tapahtuu

Asiakasohjelma saa lyhytikäisen käyttötokenin (voimassa 60 minuuttia) ja refresh-tokenin (voimassa 30 päivää). Se uusii käyttötokenin itse; et huomaa sitä.
Niin kauan kuin asiakasohjelmaa käytetään vähintään kerran 30 päivässä, yhteys pysyy aktiivisena ilman, että sinun tarvitsee tehdä mitään. Kun 30 päivää on kulunut ilman käyttöä, asiakasohjelma ohjaa sinut uudelleen hyväksyntäkulun läpi.
Yhteys näkyy kohdassa Asetukset → MCP-yhteydet, jossa on sovelluksen nimi, sen käyttämä tili, myöntämäsi oikeudet, luontiaika ja viimeisin käyttöaika.

Käyttöoikeuden peruminen

Voit perua minkä tahansa yhteyden milloin tahansa kohdassa Asetukset → MCP-yhteydet. Asiakasohjelman refresh-tokenit lakkaavat toimimasta heti, ja kesken keskustelun oleva avustaja menettää käyttöoikeuden noin kahden minuutin kuluessa, kun palvelin tarkistaa yhteyden uudelleen. Tilin ylläpitäjät voivat myös nähdä ja perua kaikki tilin yhteydet. Katso MCP-yhteyksien hallinta.

Connectorin poistaminen asiakasohjelmasta ei peru yhteyttä Funnelfeedrin puolella. Jos haluat olla varma, että tokenit eivät enää toimi, peru ne Funnelfeedrissä.

Tietoturvan yksityiskohdat

Niille, jotka haluavat tietää tarkalleen, mitä konepellin alla tapahtuu:

Kulku on OAuth 2.1 ja PKCE (S256). Asiakassalaisuutta ei ole; asiakasohjelma todistaa aloittaneensa pyynnön esittämällä paikallisesti luomansa koodin.
Funnelfeedr on sekä valtuutuspalvelin (myöntää tokenit) että resurssipalvelin (ottaa ne vastaan). Tokenit on sidottu osoitteeseen https://mcp.funnelfeedr.com/mcp, eikä niitä hyväksytä missään muualla.
Asiakasohjelmat tunnistautuvat joko Client ID Metadata Document -asiakirjalla (julkinen tunnistusasiakirja HTTPS-osoitteessa, näkyy vahvistettuna isäntänimenä) tai Dynamic Client Registration -rekisteröinnillä (näkyy vahvistamattomana).
Asiakasohjelman tokenit tunnistavat sinut. Jokainen työkalukutsu valtuutetaan roolisi ja seatiesi perusteella sillä hetkellä, kun se tehdään, ja jokainen kutsu kirjataan lokiin. Tili, jossa pyyntö suoritetaan, luetaan tallennetusta yhteydestä jokaisen pyynnön yhteydessä, ja juuri siksi yhteyden voi siirtää tiliesi välillä ilman uudelleenyhdistämistä. Tieto luetaan uudelleen vähintään kahden minuutin välein, mikä on yläraja sille, kuinka kauan peruttu tai siirretty yhteys säilyttää vanhan käyttöoikeutensa.
Standardin mukaiset löytöasiakirjat julkaistaan osoitteessa https://mcp.funnelfeedr.com/.well-known/oauth-protected-resource/mcp ja valtuutuspalvelimen osoitteessa /.well-known/oauth-authorization-server, joten jokainen standardia noudattava asiakasohjelma löytää päätepisteet itse.

Yleisiä ongelmia

"Yhteyspyyntö on vanhentunut tai jo käytetty." Aikaa on kulunut yli 10 minuuttia, tai päivitit sivun hyväksymisen jälkeen. Aloita yhteys uudelleen asiakasohjelmasta.

"Yhteyspyyntöä ei löytynyt." Linkki on puutteellinen tai katkesi kopioitaessa. Aloita alusta asiakasohjelmasta.

Hyväksyntänäkymä ei avaudu koskaan, ja asiakasohjelma ilmoittaa virheestä. Varmista, että kirjoitit palvelimen osoitteen täsmälleen muodossa https://mcp.funnelfeedr.com/mcp ja ettei mikään verkossasi (yrityksen välityspalvelin tai palomuuri) estä osoitteita api.funnelfeedr.com, app.funnelfeedr.com tai mcp.funnelfeedr.com.

Avustaja sanoo, että työkalu tarvitsee oikeuden, jota ei ole myönnetty. Poista connector asiakasohjelmasta ja yhdistä uudelleen. Asiakasohjelma päättää, mitä oikeuksia se pyytää, joten tarkista, että tarvitsemasi oikeus näkyy hyväksyntänäkymässä. Näin otat paljastamisen käyttöön myös yhteydessä, joka luotiin ennen kuin Paljastus-oikeus oli olemassa.

Lisää tapauksia käsitellään artikkelissa MCP-vianmääritys.