MCP-dokumentaatio
MCP-palvelimen työkaluviite
Täydellinen viite kaikista GetContacts MCP -palvelimen tarjoamista työkaluista. Käytä näitä työkaluja mistä tahansa MCP-yhteensopivasta AI-agentista yritysten, kontaktien ja kohderyhmien hakuun.
Pikaopas
- Luo tili. Rekisteröidy täällä
- Aktivoi tilauksesi tilisivulta ja luo sen jälkeen MCP-käyttötoken. Siirry tilille
- Liitä osoite VS Codeen tai Claudeen ja viimeistele kirjautuminen selaimessa pyydettäessä. OAuth luo tokenin automaattisesti.
Konfiguraatio
VS Codessa ja Claudessa lisää vain alla oleva MCP-osoite. Ne hoitavat OAuth-kirjautumisen ja tokenin luonnin automaattisesti.
VS Code ja Claude
Käytä hostattua MCP-osoitetta suoraan. Näissä asiakkaissa ei tarvita manuaalista JSONia tai token-asetusta.
MCP-osoite
https://app.getcontacts.example/mcp
- Lisää uusi MCP-palvelin VS Codeen tai Claudeen.
- Liitä GetContactsin MCP-osoite.
- Viimeistele selaimessa avautuva kirjautuminen, kun sitä pyydetään.
Muut MCP-asiakkaat
Jos MCP-asiakkaasi ei vielä tue MCP OAuthia, avaa tokenien hallinta luodaksesi tokenin ja kopioidaksesi siellä näkyvän valmiin JSON-konfiguraation oikealla token-arvolla.
Palvelin käyttää HTTP Streamable -transporttia. OAuth on ensisijainen vaihtoehto, kun asiakas tukee sitä; muuten autentikointi tehdään Bearer-tokenilla Authorization-headerissa.
Autentikointi
VS Code ja Claude käyttävät OAuthia automaattisesti, kun lisäät MCP-osoitteen. Asiakkaiden, jotka eivät tue OAuthia, tulee lähettää Authorization: Bearer -header voimassa olevalla MCP-käyttötokenilla. Manuaaliset tokenit on sidottu aktiiviseen tilaukseen, ne voidaan luoda, kierrättää ja mitätöidä tilisivulta, ja tokenin täysi arvo näytetään vain kerran.
Työkalut
Palvelin tarjoaa seuraavat työkalut. Kaikki työkalut vaativat autentikoinnin. Käyttö mitataan palautettujen rivien mukaan.
find_contact_by_email
Ratkaise yksittäinen kontakti sähköpostiosoitteen perusteella. Palauttaa nimen, tittelin, osaston, yrityksen ja markkinakontekstin.
Parametrit
| Nimi | Tyyppi | Pakollinen |
|---|---|---|
| string | Kyllä |
{ contact }Laskutusyksikkö: CONTACTsearch_companies
Etsi yritysehdokkaita Y-tunnuksella, verkkosivudomainilla tai yrityksen nimellä. Palauttaa priorisoidut osumat pisteillä ja osumatyypeillä.
Parametrit
| Nimi | Tyyppi | Pakollinen |
|---|---|---|
| businessId | string | Ei |
| domain | string | Ei |
| companyName | string | Ei |
| limit | number | Ei |
{ companies[] }Laskutusyksikkö: COMPANYfind_company
Ratkaise yksi yritys Y-tunnuksella tai yrityksen nimellä. Epäselvät nimiosumat palauttavat priorisoidut ehdokkaat satunnaisen yrityksen sijaan.
Parametrit
| Nimi | Tyyppi | Pakollinen |
|---|---|---|
| businessId | string | Ei |
| companyName | string | Ei |
{ company, candidates?, isAmbiguous? }Laskutusyksikkö: COMPANYfind_company_by_email_domain
Etsi yrityksiä, joiden verkkosivudomaini vastaa annettua domainia. Hyödyllinen yrityksen tunnistamiseen sähköpostiosoitteen takaa.
Parametrit
| Nimi | Tyyppi | Pakollinen |
|---|---|---|
| domain | string | Kyllä |
{ companies[] }Laskutusyksikkö: COMPANYfind_company_contacts
Nouda yhden yrityksen kontaktit. Nimihaku etenee vain, kun yritysosuma on selkeä; epäselvät osumat palauttavat ehdokkaat. Palauttaa enintään 100 kontaktia.
Parametrit
| Nimi | Tyyppi | Pakollinen |
|---|---|---|
| companyId | number | Ei |
| businessId | string | Ei |
| companyName | string | Ei |
| limit | number | Ei |
{ company, contacts[], candidates?, isAmbiguous? }Laskutusyksikkö: CONTACTfind_contact_segment
Rakenna suodatettu kohderyhmä maa-, alue-, toimiala-, vastuu-, titteli-, talous- ja perustamisvuosisuodattimilla. Palauttaa enintään 2 000 kontaktin otoksen sekä kontaktien ja työnantajien kokonaismäärät.
Parametrit
| Nimi | Tyyppi | Pakollinen |
|---|---|---|
| countryId | number | Ei |
| regionName | string | Ei |
| industryGroupId | number | Ei |
| industryId | number | Ei |
| mainResponsibilityAreaIds | number[] | Ei |
| jobFunctionIds | number[] | Ei |
| turnoverMin | number | Ei |
| turnoverMax | number | Ei |
| profitMin | number | Ei |
| profitMax | number | Ei |
| personnelMin | number | Ei |
| personnelMax | number | Ei |
| foundedYearMin | number | Ei |
| foundedYearMax | number | Ei |
| newContactsWithinDays | number | Ei |
| newResponsibilityAssignmentsWithinDays | number | Ei |
| limit | number | Ei |
{ totalCount, employerCount, returnedCount, contacts[] }Laskutusyksikkö: CONTACTLaskutus
Jokainen rivejä palauttava työkalukutsu luo laskutettavan käyttötapahtuman. Palautettujen kontaktien tai yritysten määrä kirjataan. Tyhjiä tuloksia palauttavista kutsuista ei veloiteta. Käyttö näkyy tilisivullasi ja sisältyy kuukausilaskutukseen.
MCP Playground (tulossa)
Interaktiivinen testialue on tulossa edistyneeseen konfigurointiin. Siihen asti tutustu MCP-käyttötapauksiin ja hallitse käyttötokeneita tilin asetuksista.