MCP-vianmääritys

Ratkaisut yleisimpiin ongelmiin, kun yhdistät tai käytät MCP-asiakasohjelmaa Funnelfeedrin kanssa

Tälle sivulle on koottu ongelmat, joihin käyttäjät törmäävät Funnelfeedrin MCP-palvelimen kanssa, ryhmiteltynä sen mukaan, milloin ne ilmenevät.

Yhdistettäessä

Asiakasohjelma ei löydä palvelinta tai saa siihen yhteyttä

Tarkista, että osoite on täsmälleen https://mcp.funnelfeedr.com/mcp. Ei ylimääräistä polkua, ja https eikä http.
Varmista, että asiakasohjelma tukee etä-MCP-palvelimia Streamable HTTP:n ja OAuthin kautta. Asiakasohjelmat, jotka tukevat vain paikallisia palvelimia tai staattisia API-avaimia, eivät voi muodostaa yhteyttä.
Jos olet yrityksen verkossa, kysy IT-tuelta, ovatko mcp.funnelfeedr.com, app.funnelfeedr.com ja api.funnelfeedr.com tavoitettavissa. OAuth-kulku tarvitsee ne kaikki.

Selain avautuu, mutta näyttää virheen hyväksyntänäkymän sijaan

Viesti	Syy	Ratkaisu
Yhteyspyyntö on vanhentunut tai jo käytetty.	Aikaa on kulunut yli 10 minuuttia, tai sivu ladattiin uudelleen hyväksymisen jälkeen.	Aloita yhteys uudelleen asiakasohjelmasta.
Yhteyspyyntöä ei löytynyt.	Linkki katkesi tai sitä muokattiin.	Aloita alusta asiakasohjelmasta ja anna sen avata selain itse.
Linkistä puuttuu pyynnön viite.	Hyväksyntäsivu avattiin suoraan eikä asiakasohjelman kautta.	Aloita asiakasohjelmasta.

Hyväksyntänäkymässä lukee "Vahvistamaton sovellus"

Asiakasohjelma rekisteröi itsensä ilman vahvistettavaa identiteettiä. Tämä on normaalia joillekin asiakasohjelmille, etenkin komentorivityökaluille ja itse ylläpidetyille agenteille. Jatka vain, jos aloitit yhteyden itse juuri äsken. Jos et aloittanut, napsauta Peruuta ja tarkista kohdasta Asetukset → MCP-yhteydet, onko siellä yhteyksiä, joita et tunnista.

Hyväksyin, mutta asiakasohjelma sanoo valtuutuksen epäonnistuneen

Asiakasohjelman odotusaika on ehkä umpeutunut. Yritä yhdistää uudelleen.
Claude Code kuuntelee satunnaista paikallista porttia. Paikallinen palomuuri, joka estää saapuvat yhteydet localhost-osoitteeseen, voi estää paluuvaiheen. Salli yhteys tai kokeile toisella koneella.
Tarkista, että hyväksyntänäkymän paluuosoite vastasi käyttämääsi asiakasohjelmaa. Jos se ei vastannut, älä hyväksy, vaan poista connector asiakasohjelmasta ja lisää se uudelleen.

Avustajaa käytettäessä

Avustaja ei näe yhtään Funnelfeedr-työkalua

Varmista, että connector on käytössä nykyisessä keskustelussa. Useimmissa asiakasohjelmissa connectorit voi ottaa käyttöön ja poistaa käytöstä keskustelukohtaisesti.
Tarkista Asetukset → MCP-yhteydet Funnelfeedrissä. Jos yhteys puuttuu, se on peruttu; yhdistä uudelleen asiakasohjelmasta. Yhteys, jota ei ole käytetty 30 päivään, näkyy edelleen luettelossa, mutta sen tokenit ovat vanhentuneet ja asiakasohjelman on yhdistettävä uudelleen.

Tietty työkalu puuttuu

Työkalut, joihin yhteydellä ei ole oikeutta tai seatia, on piilotettu. Yleisiä tapauksia:

Prospektointityökalut (search_organizations, search_contacts, lista- ja hakutyökalut sekä kirjoitustyökalut) edellyttävät Prospect-seatia. Ylläpitäjä jakaa seatit kohdassa Asetukset → Käyttäjät. Katso Seatit.
Kirjoitustyökalut (create_list, add_organizations_to_list, remove_organizations_from_list, add_contacts_to_list, remove_contacts_from_list, save_search, create_ideal_customer_profile) edellyttävät Kirjoitus-oikeutta. Jos yhteydellä on vain Luku-oikeus, poista connector asiakasohjelmasta, yhdistä uudelleen ja tarkista, että Kirjoitus näkyy hyväksyntänäkymässä. switch_account on poikkeus: se toimii myös yhteydellä, jolla on vain lukuoikeus.
Paljastustyökalut (quote_reveal, reveal_contacts) edellyttävät Paljastus-oikeutta (mcp:spend). Ne ovat aina joko piilossa tai näkyvissä yhdessä, joten jos avustaja ei pysty edes hinnoittelemaan paljastusta, oikeus puuttuu. Katso alla.

Avustaja vastasi väärästä tilistä

Katso vastauksen ensimmäistä riviä: jos kuulut useaan Funnelfeedr-tiliin, vastaukset alkavat sillä tilillä, josta ne tulevat. Jos tili on väärä, voit joko sanoa avustajalle "vaihda tiliin Example AB" tai muuttaa saraketta Tili kohdassa Asetukset → MCP-yhteydet. Kun pyydät vaihtoa keskustelussa, se tulee voimaan avustajan seuraavasta pyynnöstä. Kun muutat sitä Tili-sarakkeessa, muutos voi kestää noin kaksi minuuttia, joten odota sen verran ennen kuin kysyt uudelleen. Kummassakin tapauksessa jo saamasi vastaus tuotettiin vanhassa tilissä, joten esitä kysymyksesi uudelleen sen jälkeen.

"Avustaja sanoo, ettei se voi vaihtaa tiliä"

Jos avustaja kertoo, että yhteys valtuutettiin ennen kuin tilin vaihtaminen oli mahdollista, se käyttää Funnelfeedrin vanhemman version luomaa yhteyttä. Poista connector asiakasohjelmasta ja yhdistä uudelleen; hyväksyntänäkymässä voit valita tilin suoraan. Voit myös ohjata nykyisen yhteyden oikeaan tiliin kohdassa Asetukset → MCP-yhteydet yhdistämättä uudelleen.

Jos avustaja sen sijaan sanoo, ettei tili ole sellainen, johon kuulut, käytä tilin tarkkaa nimeä sellaisena kuin se näkyy kohdassa Asetukset → MCP-yhteydet, tai pyydä avustajaa luettelemaan tilit, joihin se voi vaihtaa.

"Haku osui liian moneen kohteeseen järjestettäväksi"

Vapaamuotoinen kuvaus järjestää jokaisen yrityksen, joka suodattimien jälkeen jää jäljelle, joten suodattimien on rajattava joukko hallittavaksi. Lisää jotain konkreettista (toimialakoodi, tagi, henkilöstö- tai liikevaihtoväli, alue, kunta tai kaupunki) ja kysy uudelleen. Esimerkiksi "hammaslääkäriasemat Skånessa, joissa on vähintään 5 työntekijää" toimii, kun taas "hammaslääkäriasemat" ei toimi.

"query was supplied with no filter other than the market"

Sama sääntö, mutta haku hylätään jo ennen kuin se suoritetaan: pelkkä kuvaus ei ole haku. Lisää vähintään yksi tavallinen suodatin markkinan lisäksi. Jos todella haluat kaiken yhdeltä toimialalta, jätä kuvaus pois ja käytä pelkkiä suodattimia. Järjestämätön haku ei tarvitse järjestämisen lähdettä.

Avustaja ei löytänyt mitään tagilla, teknologialla tai kunnalla

Nämä suodattimet vaativat täsmällisen osuman, joten arvattu arvo palauttaa tyhjän tuloksen eikä virhettä. Pyydä avustajaa tarkistamaan sallitut arvot ensin (sillä on get_filter_vocabulary tageille, teknologioille, yhtiömuodoille, kunnille, alueille, yhteyshenkilöiden osaamisalueille ja kohderooleille). Huomaa myös, että useat tagit tai avainsanat osuvat yritykseen, jolla on mikä tahansa niistä, eivät kaikki. Rajataksesi hakua anna vähemmän arvoja tai sulje jotain pois.

"The connection is not authorized for … the required OAuth scope was not granted"

Yhteydellä on Luku-oikeus, mutta avustaja yritti kirjoittaa. Yhdistä uudelleen ja tarkista, että Kirjoitus-oikeus näkyy hyväksyntänäkymässä. Katso MCP-asiakasohjelman valtuuttaminen OAuthilla.

"… requires the … permission, which this user's role does not grant"

Funnelfeedr-roolistasi puuttuu käyttöoikeus, jota työkalu vastaa (viesti mainitsee sen, esimerkiksi leads:read tai leads:write). Ylläpitäjä voi muuttaa rooliasi kohdassa Asetukset → Käyttäjät. MCP-palvelin ei koskaan anna enempää kuin verkkosovellus antaisi.

"… requires the … capability"

Katso Tietty työkalu puuttuu yllä.

"… was rate limited"

Saavutit minuuttikohtaisen rajan (60 pyyntöä, 20 hakua, 10 kirjoitusta tai 5 paljastusta minuutissa käyttäjää kohden; useiden yritysten hakeminen kerralla find_organization-työkalulla lasketaan yhdeksi hauksi). Virheilmoitus kertoo avustajalle, montako sekuntia sen pitää odottaa, ja useimmat avustajat yrittävät uudelleen itse. Jos näin käy usein, pyydä avustajaa käyttämään suurempia sivukokoja tai harvempia, laajempia hakuja. Paljastuksilla on tarkoituksella tiukin raja, koska jokainen niistä kuluttaa krediittejä. Suuren erän kohdalla avustaja käy sen todennäköisesti läpi kutsu kerrallaan.

Connector sanoo, ettei se voi paljastaa, tai pyytää yhdistämään uudelleen

Yhteystietojen paljastaminen vaatii oman hyväksyntänsä: Paljastus-oikeuden (mcp:spend), joka on erillään Luku- ja Kirjoitus-oikeuksista, koska se kuluttaa tilisi krediittejä. Useilla eri oireilla on samat syyt.

Avustaja sanoo, ettei se voi paljastaa yhteyshenkilöitä, tai ei mainitse paljastamista lainkaan. Yhteydeltä puuttuu Paljastus-oikeus, joten molemmat paljastustyökalut ovat piilossa siltä. Näin käy jokaisessa yhteydessä, joka hyväksyttiin ennen kuin paljastaminen oli mahdollista, eikä oikeutta voi lisätä jälkikäteen. Poista connector asiakasohjelmasta, lisää se uudelleen ja tarkista, että Paljastus näkyy hyväksyntänäkymässä. Aiemmin hyväksytty Kirjoitus-oikeus ei kata tätä.
"The connection is not authorized for 'reveal_contacts': the required OAuth scope 'mcp:spend' was not granted." Sama asia suoraan sanottuna. Sama ratkaisu.
"This reveal costs … credits and the account has …" Tilillä ei ole tarpeeksi krediittejä, joten mitään ei paljastettu eikä mitään veloitettu. Osta krediittejä kohdassa Asetukset → Laskutus ja kysy uudelleen.
"The confirmation expired" / "no longer matches" / "is not valid." Vahvistus, johon paljastus perustuu, toimii kerran ja on voimassa viisi minuuttia, ja se on sidottu täsmälleen niihin yhteyshenkilöihin ja täsmälleen siihen hintaan, jotka sinulle näytettiin. Jos vastaamisessa kesti hetki tai joukko muuttui välillä, paljastus hylätään sen sijaan, että siitä veloitettaisiin hinta, jota et hyväksynyt. Kysy vain uudelleen: avustaja hinnoittelee uudelleen, ja sinä vahvistat uuden summan.
Asiakasohjelma pyytää jatkuvasti vahvistusta. Näin on tarkoitettu. reveal_contacts on merkitty kuluja aiheuttavaksi toiminnoksi, joten esimerkiksi Claude kysyy jokaisella kutsulla. Maksuton quote_reveal ei kysy, koska se ei veloita mitään.

Yhteyshenkilöiden sähköpostiosoitteet ja puhelinnumerot on peitetty

Tämä on odotettua, kunnes yhteyshenkilö on paljastettu. Peitetystä sähköpostiosoitteesta näkyy vain verkkotunnus ja peitetystä puhelinnumerosta vain viisi ensimmäistä numeroa. Voit edetä kahdella tavalla: paljasta yhteyshenkilö verkkosovelluksessa, jolloin avustaja näkee tiedot seuraavalla kutsulla, tai pyydä avustajaa tekemään se. Se kertoo ensin hinnan ja paljastaa, kun olet hyväksynyt. Yhteyshenkilöt, jotka tilisi on paljastanut viimeisen vuoden aikana, ovat jo näkyvissä eivätkä maksa mitään.

Avustaja palauttaa vanhentuneita tuloksia

Jotkin asiakasohjelmat tallentavat työkalujen tuloksia välimuistiin hetkeksi. Kysy uudelleen tai aloita uusi keskustelu.

Yhteys lakkasi toimimasta muutaman viikon jälkeen

Refresh-tokenit vanhenevat, kun niitä ei ole käytetty 30 päivään. Yhdistä uudelleen asiakasohjelmasta; aiempi hyväksyntäsi muistetaan. Näkymä näyttää oikeudet merkinnällä Jo myönnetty, tai se ohitetaan kokonaan, jos kuulut vain yhteen tiliin eikä asiakasohjelma pyydä mitään uutta.

Vieläkin ongelmia?

Tarkista Asetukset → MCP-yhteydet, peru yhteys, poista connector asiakasohjelmasta ja määritä se uudelleen alusta ohjeen Yhdistä Claude, ChatGPT tai muu MCP-asiakasohjelma mukaisesti. Jos se ei vieläkään toimi, ota yhteyttä Funnelfeedrin tukeen ja kerro käyttämäsi asiakasohjelma, virheilmoituksen tarkka teksti ja suunnilleen milloin ongelma ilmeni, jotta löydämme vastaavan lokimerkinnän.