MCP-työkalujen käsikirja
Kaikki Funnelfeedrin MCP-palvelimen työkalut, mitä ne tekevät ja mitä scopea, seatia ja oikeutta kukin työkalu vaatii
MCP-asiakasohjelma näkee Funnelfeedrin joukkona työkaluja. Avustaja valitsee kutsuttavan työkalun sen perusteella, mitä kysyt. Tällä sivulla on kaikki 25 työkalua, joten tiedät, mitä yhdistetty avustaja voi tehdä ja mitä ei.
Jokainen kutsu suoritetaan yhteyden hyväksyneen käyttäjän nimissä siinä tilissä, johon yhteys osoittaa. Työkalu toimii vain, jos yhteydelle on myönnetty oikea scope, käyttäjällä on oikea seat (katso Seatit) ja käyttäjän Funnelfeedr-rooli antaa vastaavan oikeuden. Työkalut, joilta puuttuu scope tai seat, on piilotettu avustajalta kokonaan. Työkalu, jota roolisi ei salli, näkyy edelleen, mutta se kieltäytyy, kun sitä kutsutaan.
Lukutyökalut
Kaikki lukutyökalut vaativat scopen Luku (mcp:read).
| Työkalu | Mitä se tekee | Roolioikeus |
|---|---|---|
get_context | Avustajan ensimmäinen, suuntaa antava kutsu: mihin tiliin yhteys osoittaa, tilin oma yritysprofiili, tilin kohderoolit, sen ihanneasiakasprofiilit ja pisteytysprofiilit, muut tilit, joihin yhteyden voi siirtää, sekä onko tilillä ilmainen kokeilujakso, milloin se päättyy ja kuinka paljon krediittejä on jäljellä. | Kaikki käyttäjät |
search_organizations | Rakentaa yrityssegmentin pohjoismaisesta rekisteristä. Katso suodattimien ja järjestyksen yhteenveto alempana. Palauttaa sivun, jossa on id, organisaationumero, Funnelfeedr-URL ja, jos haku on pisteytetty, pistemäärä. | Liidien katselu |
find_organization | Hakee yrityksiä, jotka osaat jo nimetä, nimen, verkkotunnuksen tai organisaationumeron perusteella, enintään 25 kerrallaan. Jokainen osuma kertoo, mitä tililläsi jo on yrityksestä: asiakas, CRM:ssä, viety ja kenelle, sekä millä listoilla se on. | Kaikki käyttäjät |
get_organization | Yhden yrityksen täydellinen profiili: rekisteri-, talous- ja CRM-suhdetiedot. Hyväksyy Funnelfeedr-id:n, organisaationumeron (SE, NO, DK, FI), verkkotunnuksen tai Funnelfeedr-URL:n. | Kaikki käyttäjät |
get_organizations | Samat tiedot enintään 50 yrityksestä yhdellä kutsulla sekä luettelo tunnisteista, jotka eivät tuottaneet osumaa. | Kaikki käyttäjät |
search_contacts | Hakee henkilöitä yritysten välillä roolin (tehtävänimike, osa-alue ja senioriteetti sekä yhteystiedot, jotka heillä on oltava, esimerkiksi suora puhelinnumero) ja työpaikan yritysprofiilin perusteella. Haun voi rajata valittuihin organisaatioihin tai yhteen organisaatiolistaan. Sähköposti ja puhelin on peitetty, ellei tilisi ole jo paljastanut yhteyshenkilöä. Niiden paljastamiseen avustaja käyttää kahta alla kuvattua paljastustyökalua. | Liidien katselu |
get_organization_contacts | Kaikki henkilöt, jotka Funnelfeedr tuntee yhdessä yrityksessä, järjestettynä kuten verkkosovelluksessa ja samalla tavalla peitettyinä. | Kaikki käyttäjät |
list_lists | Tilisi listat, sekä organisaatio- että yhteyshenkilölistat, id:n, nimen, tyypin ja koon kanssa. | Liidien katselu |
get_list | Yhden listan organisaatiot tai yhteyshenkilöt sivu kerrallaan. | Liidien katselu |
get_saved_searches | Tallennetut prospektointihakusi, halutessasi selkokielisen yhteenvedon kera siitä, mitä kukin haku suodattaa. | Liidien katselu |
run_saved_search | Suorittaa yhden tallennetun haun id:n perusteella omilla suodattimillaan, markkinallaan ja järjestyksellään, myös suodattimilla, joita search_organizations ei pysty ilmaisemaan. | Liidien katselu |
get_filter_vocabulary | Arvot, jotka tarkat suodattimet hyväksyvät: tagit, teknologiat, yhtiömuodot, kunnat, maakunnat, yhteyshenkilöiden osa-alueet ja tilillesi määritetyt kohderoolit. | Liidien katselu |
search_knowledge | Semanttinen haku yrityksesi tietopankista: tuote- ja hintatiedot, myyntiprosessit, vastaväitteiden käsittely, asemointi, käytännöt. Palauttaa tekstikatkelmia ja linkin lähdemerkintään. | Kaikki käyttäjät |
search | ChatGPT Deep Research -sopimus: vapaatekstihaku, joka palauttaa asiakirjojen id:t, otsikot ja lainattavat URL-osoitteet. | Kaikki käyttäjät |
fetch | ChatGPT Deep Research -sopimus: yhden asiakirjan koko teksti id:n perusteella. | Kaikki käyttäjät |
Mitä search_organizations osaa
- Suodattaa markkinan (yksi kerrallaan: SE, NO, DK tai FI), nimen, avainsanojen, toimialakoodin, kunnan, maakunnan, kaupungin, henkilöstömäärän, liikevaihdon, yhtiömuodon, perustamisvuoden, verkkoteknologian ja tagien perusteella.
- Suodattaa henkilöiden perusteella: yritykset, joissa työskentelee joku tilisi kohderooleja vastaava, tai tilapäiset ehdot kuten "myynnin päättäjä, jolla on sähköpostiosoite" tai "talousjohtaja, jolla on suora puhelinnumero". "Puhelinnumero" kattaa myös yrityksen vaihteen. "Suora puhelinnumero" kattaa vain henkilön oman numeron.
- Suodattaa suhteenne perusteella: vain asiakkaat tai asiakkaat pois rajattuina, vain CRM:ssänne olevat yritykset tai ne pois rajattuina, yritykset, joihin kukaan ei ole ollut yhteydessä lainkaan, tai yritykset, joihin on oltu yhteydessä viimeisten N päivän aikana.
- Rajata pois: jokaisella yllä olevalla suodattimella on vastinpari, joka hylkää hyväksymisen sijaan, joten "valmistavat yritykset, mutta ei tämän listan yrityksiä" on yksi haku.
- Järjestää yhden lähteen perusteella kerrallaan: selkokielinen kuvaus siitä, mitä etsit, yksi ihanneasiakasprofiileistanne, pisteytysprofiili tai samankaltaisuus yhden esimerkkiyrityksen kanssa.
- Lajitella pistemäärän, liikevaihdon, henkilöstömäärän tai nimen mukaan.
Selkokielinen kuvaus vaatii lisäksi vähintään yhden tavallisen suodattimen, koska järjestyksen on pisteytettävä kaikki, mitä suodattimet jättävät jäljelle.
Kirjoitustyökalut
Kirjoitustyökalut vaativat scopen Kirjoitus (mcp:write). Useimmat vaativat lisäksi oikeuden Liidien muokkaus. Poikkeukset on mainittu.
| Työkalu | Mitä se tekee |
|---|---|
create_list | Luo tilillesi tyhjän listan: organisaatiolistan, ellei yhteyshenkilölistaa pyydetä. |
add_organizations_to_list | Lisää organisaatioita olemassa olevaan organisaatiolistaan. Vain lisää, ei poista. Enintään 25 kutsua kohden. Avustaja jakaa suuremmat joukot osiin. Voi tallentaa perustelun, joka näkyy jokaisella lisätyllä rivillä. |
remove_organizations_from_list | Poistaa organisaatioita listalta, enintään 25 kutsua kohden. Merkitty tuhoavaksi, joten Clauden kaltaiset asiakasohjelmat pyytävät sinua vahvistamaan ennen suoritusta. |
add_contacts_to_list | Lisää yhteyshenkilöitä olemassa olevaan yhteyshenkilölistaan. Vain lisää, ei poista. Enintään 25 kutsua kohden. Voi tallentaa perustelun, joka näkyy jokaisella lisätyllä rivillä. |
remove_contacts_from_list | Poistaa yhteyshenkilöitä yhteyshenkilölistalta, enintään 25 kutsua kohden. Merkitty tuhoavaksi, joten asiakasohjelma pyytää sinua vahvistamaan. |
save_search | Tallentaa joukon search_organizations-suodattimia nimettynä tallennettuna hakuna, jonka voit suorittaa myöhemmin uudelleen. Se ei voi tallentaa selkokielistä kuvausta. Käytä siihen ihanneasiakasprofiilia. |
create_ideal_customer_profile | Muuttaa kuvauksen ihanneasiakkaastanne profiiliksi, jonka id:llä voi järjestää myöhempiä hakuja. Ei vaadi lisäoikeutta roolilta, aivan kuten verkkosovelluksessa. |
switch_account | Osoittaa yhteyden toiseen Funnelfeedr-tiliin, jonka jäsen olet. Tulee voimaan avustajan seuraavasta pyynnöstä. Vaatii vain scopen Luku, koska se ei muuta tietojasi. Se on merkitty tuhoavaksi, joten asiakasohjelma voi pyytää sinua vahvistamaan vaihdon. |
create_account | Luo uuden Funnelfeedr-tilin yritykselle sen verkkosivuston perusteella, täsmälleen kuten Lisää tili tilinvaihtimessa, ja osoittaa yhteyden siihen. Jos yrityksellä on jo tili, jonka jäsen olet, se vaihtaa siihen tiliin eikä luo kaksoiskappaletta. Jos on olemassa tili, jonka jäsen et ole, se pysähtyy ja pyytää sinua hankkimaan kutsun. Vaatii oikeuden hallita tilin asetuksia, joka järjestelmänvalvojilla on, sekä tilaa uudelle tilille tilauksessanne. |
Muita kirjoitustyökaluja ei ole.
Paljastustyökalut
Nämä kaksi ovat ainoat työkalut, jotka voivat käyttää tilisi krediittejä, ja ne toimivat vain yhteydessä, jolle olet myöntänyt scopen Paljastus (mcp:spend). Luku- tai Kirjoitus-scopen myöntäminen ei myönnä tätä: listojen hyväksyminen ei ole sama asia kuin kulun hyväksyminen. Jos yhdistit ennen kuin paljastaminen oli mahdollista, yhdistä uudelleen ja tarkista, että Paljastus-scope näkyy hyväksymisnäytöllä. Siihen asti avustaja ei näe näitä työkaluja lainkaan.
| Työkalu | Mitä se tekee |
|---|---|
quote_reveal | Maksuton. Hinnoittelee, mitä yhteyshenkilöjoukon paljastaminen maksaisi: yhteyshenkilöä kohden ja yhteensä, merkiten ne, jotka tilisi on jo paljastanut ja saa siksi maksutta, sekä nykyisen krediittisaldosi. Se ei paljasta mitään, ei veloita mitään eikä koskaan palauta oikeaa sähköpostiosoitetta tai puhelinnumeroa. |
reveal_contacts | Käyttää krediittejä. Paljastaa enintään 25 yhteyshenkilön sähköpostiosoitteet ja puhelinnumerot ja palauttaa ne. Se toimii vain vahvistuksella, joka on saatu hetkeä aiemmin tehdystä quote_reveal-kutsusta täsmälleen samoille yhteyshenkilöille. |
Näin paljastus etenee
- Pyydät yhteystietoja. Avustaja kutsuu aina ensin
quote_reveal-työkalua ja kertoo tarkan hinnan ja saldosi. - Hyväksyt. Avustaja kutsuu sitten
reveal_contacts-työkalua, joka on merkitty kuluja aiheuttavaksi toiminnoksi, joten Claude ja vastaavat asiakasohjelmat pyytävät sinua vahvistamaan ennen suoritusta. - Tiedot palautuvat peittämättöminä, ja mukana on hinta ja jäljellä oleva saldo.
Hyvä tietää:
- Hinta on tilisi tavallinen krediittihinta paljastukselle. MCP ei lisää mitään päälle, eikä erillistä MCP-laskutusta ole.
- Hintalaskelma on tarkka, ei arvio. Sen laskee sama koodi, joka tekee veloituksen.
- Jo paljastetut yhteyshenkilöt ovat maksuttomia. Paljastus on voimassa vuoden, ja uudelleen paljastaminen sen vuoden aikana ei maksa mitään. Nämä yhteyshenkilöt on merkitty hintalaskelmaan.
- LinkedIn-URL:t ovat aina maksuttomia, ja yhteyshenkilötyökalut palauttavat ne jo kokonaisina, joten ne eivät koskaan kuulu paljastukseen.
- Enintään 25 yhteyshenkilöä kutsua kohden ja enintään 5 paljastusta minuutissa. Suuremmat joukot jaetaan useaan hintalaskelmaan ja useaan vahvistukseen, joten hyväksyt jokaisen kulun.
- Jos saldo ei riitä, mitään ei tapahdu. Vahvistusta ei anneta eikä mitään veloiteta. Osta krediittejä kohdasta Asetukset → Laskutus ja pyydä uudelleen.
- Vahvistus toimii kerran ja vanhenee viidessä minuutissa. Jos yhteyshenkilöjoukko tai hinta on sillä välin muuttunut, paljastus hylätään sen sijaan, että se veloitettaisiin hinnalla, jota et nähnyt.
Vaikka Paljastus-scope olisi myönnetty, yhdistetty avustaja ei silti voi:
- lähettää organisaatioita tai yhteyshenkilöitä CRM:ääsi
- paljastaa muuta kuin yhteyshenkilöiden sähköpostiosoitteita ja puhelinnumeroita
- lähettää sähköpostia, soittaa puheluita tai varata mitään
- poistaa tai nimetä uudelleen listoja tai muokata olemassa olevaa tallennettua hakua
- muuttaa asetuksia, käyttäjiä tai laskutusta
- ostaa krediittejä, vaihtaa tilausta tai koskea maksutietoihin
Oikean asian pyytäminen
Avustaja valitsee työkalut. Sinun tarvitsee vain kertoa selvästi, mitä haluat. Esimerkkejä pyynnöistä, jotka käyttävät uudempia ominaisuuksia:
Ovatko Volvo Group, Scania ja Sandvik meidän Funnelfeedrissämme, ja onko ne jo CRM:ssä?
Etsi Nordkap Logistik AB:n kaltaisia yrityksiä Skånesta, joiden henkilöstömäärä on 20:n ja 100:n välillä, ohita ne, joihin olemme jo olleet yhteydessä tällä neljänneksellä, ja lisää kymmenen parasta uudelle listalle.
Järjestä göteborgilaiset valmistavat yritykset, joissa on vähintään 50 työntekijää, ihanneasiakasprofiilimme "Mid-market operations" mukaan, ja näytä ne, joissa meillä on tuotannon päättäjän sähköpostiosoite.
Suorita tallennettu hakuni "Retail SE Q3" ja kerro, mitkä 20 parhaasta eivät vielä ole CRM:ssä.
Paljonko maksaisi saada sähköpostiosoitteet niille viidelle tuotantopäällikölle, jotka juuri löysit? Jos se on alle 10 krediittiä, jatka.
Kaksi tapaa parantaa vastauksia: anna avustajan kutsua ensin get_context, jotta se käyttää todellisia ihanneasiakasprofiilejanne ja kohderoolejanne arvaamisen sijaan, ja mainitse sinulle tärkeä suodatin pelkän kuvauksen sijaan. Pelkkä "SaaS-yritykset" on liian laaja järjestettäväksi.
Tilit
Jos kuulut useaan Funnelfeedr-tiliin, vastaukset alkavat sen tilin nimellä, josta ne tulevat, ja voit pyytää avustajaa vaihtamaan: "vaihda tiliin Example AB". Muutos koskee seuraavasta pyynnöstä alkaen, ei jo annettuja vastauksia. Voit vaihtaa tiliä myös kohdassa Asetukset → MCP-yhteydet, jolloin muutoksen välittyminen avustajalle kestää enintään noin kaksi minuuttia. Katso MCP-yhteyksien hallinta.
Seatit
| Taso | Työkalut | Kenellä se on |
|---|---|---|
| Perustaso | get_context, switch_account, create_account, find_organization, get_organization, get_organizations, get_organization_contacts, search_knowledge, fetch, quote_reveal, reveal_contacts | Kaikilla aktiivisen tilin käyttäjillä seatista riippumatta |
| Prospektointi | search_organizations, search_contacts, get_filter_vocabulary, search, list_lists, get_list, get_saved_searches, run_saved_search ja kaikki kirjoitustyökalut paitsi switch_account ja create_account | Käyttäjillä, joilla on Prospect-seat |
Close- tai Meet-seatilla voi edelleen hakea yrityksiä, joiden kanssa työskentelee, lukea tietopankkia ja paljastaa yhteyshenkilön, mutta ei hakea yritystietokannasta eikä työskennellä listojen kanssa. Järjestelmänvalvoja määrittää seatit kohdassa Asetukset → Käyttäjät. Ilman Prospect-seatia prospektointityökaluja ei näytetä avustajalle lainkaan.
Kutsurajat
Rajat koskevat käyttäjää minuuttia kohden:
| Luokka | Raja |
|---|---|
| Kaikki pyynnöt | 60 minuutissa |
Hakutyökalut (search_organizations, find_organization, get_organizations, run_saved_search, search_contacts, search_knowledge, search) | 20 minuutissa |
Kirjoitustyökalut (mukaan lukien switch_account) | 10 minuutissa |
reveal_contacts | 5 minuutissa |
quote_reveal on maksuton, eikä sitä rajoiteta yleisen 60 kutsun minuuttirajan lisäksi, joten avustajaa ei koskaan estetä tarkistamasta hintaa ensin.
Kun raja täyttyy, työkalu palauttaa virheen, joka kertoo avustajalle, kuinka kauan odottaa. Avustajat hoitavat tämän yleensä itse pitämällä tauon ja yrittämällä uudelleen.
Tietojen käsittely
- Tulokset sisältävät samat tiedot, jotka näkisit Funnelfeedrin verkkosovelluksessa, oikeuksiesi ja näkyvyysasetustesi mukaan suodatettuina.
- Yhteyshenkilöiden sähköpostiosoitteet ja puhelinnumerot ovat peitettyjä, ellei yhteyshenkilöä ole jo paljastettu tililläsi tai hyväksyt paljastuksen
reveal_contacts-työkalulla. Peitetystä sähköpostiosoitteesta näkyy vain verkkotunnus ja peitetystä puhelinnumerosta vain viisi ensimmäistä numeroa. - Jokainen työkalukutsu, sallittu tai estetty, kirjataan käyttäjän, tilin ja sovelluksen kanssa. Paljastuksista kirjataan lisäksi, mitä ne maksoivat ja että vahvistit ne.
- Avustajasi palveluntarjoaja (Anthropic, OpenAI ja niin edelleen) saa työkalujen tulokset osana keskusteluasi oman palveluehtojensa mukaisesti.