**MCP-kiszolgáló** · [API](https://to.co/hu-hu/docs/api?format=md)

# A to.co MCP-kiszolgáló

Engedje, hogy egy AI-asszisztens megkeresse a to.co-n közzétett vállalkozási adatlapokat, és naprakészen tartsa az Ön saját vállalkozási profilját. A vállalkozások keresése ingyenes, és nem igényel bejelentkezést.

[Asszisztense összekapcsolása](#connect) · [Eszközök](#tools)

- Kiszolgáló URL-je: `https://mcp.to.co/mcp`
- Átvitel: Streamable HTTP (MCP-protokoll változatai: 2026-07-28, 2025-11-25)

<a id="connect"></a>
## Asszisztense összekapcsolása

Adja hozzá a kiszolgáló URL-jét az asszisztenséhez. A lekérdezések azonnal működnek. Hogy engedje kezelni a saját vállalkozásait, jelentkezzen be a to.co-ra, amikor kéri, a Bejelentkezés alatt leírtak szerint.

### Claude (claude.ai and the desktop app)

1. Open Settings, then Connectors, and choose Add custom connector.
2. Name it to.co and enter https://mcp.to.co/mcp as the URL.
3. Leave the client ID and secret empty. Lookups work at once; to let Claude work on your own businesses, sign in to to.co and choose Allow when it asks.

### Claude Code

1. Run this in a terminal, then run /mcp in Claude Code and choose toco to sign in when you want the companies and locations tools.

```sh
claude mcp add --transport http toco https://mcp.to.co/mcp
```

### Cursor

1. Add this to ~/.cursor/mcp.json (or .cursor/mcp.json in a project). Cursor asks you to sign in to to.co when the companies or locations tool first needs it.

```json
{
  "mcpServers": {
    "toco": {
      "url": "https://mcp.to.co/mcp"
    }
  }
}
```

### VS Code

1. Add this to .vscode/mcp.json, then start the server from the MCP view. VS Code asks you to sign in to to.co when the companies or locations tool first needs it.

```json
{
  "servers": {
    "toco": {
      "type": "http",
      "url": "https://mcp.to.co/mcp"
    }
  }
}
```

### ChatGPT

1. In Settings, open Apps and connectors and turn on developer mode under Advanced.
2. Create a connector with https://mcp.to.co/mcp as the server URL and OAuth as the authentication.

### Windsurf

1. Add this to ~/.codeium/windsurf/mcp_config.json. The Authorization header, with an agent token, is needed only for the companies and locations tools; leave it out for lookups.

```json
{
  "mcpServers": {
    "toco": {
      "serverUrl": "https://mcp.to.co/mcp",
      "headers": {
        "Authorization": "Bearer toco_at_…"
      }
    }
  }
}
```

### Any other client

1. Use Streamable HTTP at https://mcp.to.co/mcp.
2. For the companies and locations tools, sign in with OAuth (the server advertises https://my.to.co in its protected resource metadata) or send Authorization: Bearer with an agent token.

## Bejelentkezés

Az azonosítási és súgóeszközök nem igényelnek bejelentkezést. A cégek és telephelyek eszközei azokon a vállalkozásokon dolgoznak, amelyeket a fiókja birtokol, ezért az asszisztensnek Ön nevében kell eljárnia. Ennek két módja van.

Bejelentkezés a to.co-val (OAuth). Amikor az asszisztens először használja a cégek vagy telephelyek eszközét, a kiszolgáló azt válaszolja, hogy bejelentkezés kell, és az asszisztens megnyit egy to.co-oldalt, ahol Ön bejelentkezik, és látja, mit kér: a vállalkozásai olvasását és a nyilvános profiljuk módosítását. A módosításokat kipipálhatja. Ezután egy egy óráig érvényes tokent kap, amely magától megújul; bármikor leválaszthatja a Bejelentkezés és biztonság oldalon. Ez az MCP-bejelentkezést (OAuth) támogató asszisztensekben működik.

Vagy használjon ügynöktokent, szkriptekhez és MCP-bejelentkezés nélküli asszisztensekhez. Hozzon létre egyet a my.to.co Bejelentkezés és biztonság oldalán. 90 napig érvényes, toco_at_ előtaggal kezdődik, mindent megtehet, amit a cégek és telephelyek eszközei, és ott visszavonhatja. Küldje így: Authorization: Bearer toco_at_…. Kezelje jelszóként: a tokeneket weboldalakról elutasítjuk. Bármelyik módon a kiszolgáló minden hívásnál ellenőrzi a tulajdonjogot: egy másik fiók vállalkozása „nem található”-ként jelenik meg.

[Csatlakoztatott alkalmazások és tokenek kezelése](https://my.to.co/account/security)

<a id="business"></a>
## Minden vállalkozás saját kiszolgálója

A to.co-n minden közzétett vállalkozásnak saját MCP-kiszolgálója is van, a saját címén, a végén /mcp-vel, például https://mybusiness.uk.to.co/mcp. Ez az mcp.to.co-tól különálló kiszolgáló, saját eszközökkel erről az egy vállalkozásról: mit tesz közzé az oldalán (ki ez, hogyan érhető el, mikor és hol van nyitva, és mit enged az asszisztenseknek), az üzenetek, ahol a vállalkozás fogadja őket, és a tulajdonosának szóló eszközök. Egyik sem keres másik vállalkozást, és egyik sem fogad címet. A vállalkozásról való kérdezés ingyenes, és nem igényel bejelentkezést. Minden vállalkozás kiszolgálóját a saját címén, a /mcp/docs oldalon dokumentáljuk, az olvasó nyelvén. A vállalkozás oldala hivatkozik rá, és az llms.txt fájlja, valamint egy Link fejléc (rel="service-desc") a kiszolgáló kártyájára, a /.well-known/mcp.json címre mutat.

A csatlakozáshoz adja hozzá a vállalkozás /mcp-re végződő címét az asszisztenséhez egyéni összekötőként vagy MCP-kiszolgálóként. A bejelentkezés a Bejelentkezés alatt leírtak szerint működik, és a kapcsolat csak arra a vállalkozásra szól: egy másik vállalkozás vagy az mcp.to.co tokenjét elutasítjuk. A tulajdonos a címet a my.to.co-ban, a vállalkozás AI-asszisztensek lapján találja.

Egy vállalkozás lekérdezése semmibe sem kerül, bejelentkezve vagy anélkül: minden hívó (egy token, vagy bejelentkezés nélkül egy IP-cím) óránként 600 lekérdezést végezhet az egyes vállalkozások kiszolgálóján. A bejelentkezést igénylő hívást az fizeti, aki kezdeményezi. A tulajdonos fiókja a vállalkozás havi API-krediteit használja, minden csomagon. Bárki másnak saját kerete van minden vállalkozásra együtt: óránként 60 hívás és havonta 500. A hónap 500 hívásán túl a saját fiókjukban lévő, a to.co-n lévő vállalkozás fizet a havi API-krediteiből; ilyen nélkül a hívásokat elutasítjuk 1-jéig. Az elutasítások HTTP 429-ek: credits_exhausted, ha a vállalkozás hónapja elfogyott, allowance_exhausted a személy hónapjára, és rate_limited Retry-After fejléccel egy órára.

A Pro és a Grow csomagon a tulajdonos engedheti, hogy az asszisztensek üzenetet küldjenek a vállalkozásnak az üzenetek eszközzel, miután az a személy, akinek az asszisztens dolgozik, látta, és kérte a küldést, a saját nevével és elérhetőségeivel. Kikapcsolt, amíg a tulajdonos be nem kapcsolja.

<a id="tools"></a>
## Eszközök

Minden kapcsolat rendelkezik az alábbi négy eszközzel; a bejelentkezett fiókok bizonylatokhoz, kereskedelmi partnerekhez és üzenetekhez is kapnak eszközöket. Mindegyik action argumentumot fogad, amely megmondja, mit tegyen, és az adott művelet által igényelt további argumentumokat. Az argumentumok és az eredmények mezőnevei snake_case-ek, mint a to.co API-ban. Minden eredmény JSON, strukturált tartalomként, megfelelő kimeneti sémával. A nyitvatartás megtartja a tárolt formáját: day (0 vasárnap, 6 szombat) vagy date (YYYY-MM-DD), open, open_time és close_time 24 órás HH:mm formátumban, ahol a nyitásnál korábbi zárási idő éjfélen túl tart.

### `identity` — Look up a business identity

Look up published business identities on to.co. Anyone can call it; no sign-in needed. Records are the public projection: never internal keys or account details.

- `resolve` (bárki, csak olvasás): The business at a to.co address.
  - `host` (string, kötelező): A to.co address, e.g. mybusiness.uk.to.co or mybusiness-bristol.biz.to.co
- `website` (bárki, csak olvasás): The businesses whose website is on this hostname. A website can belong to more than one business, so this returns a list.
  - `website` (string, kötelező): The business's own website, e.g. mybusiness.com or https://www.mybusiness.com/
- `search` (bárki, csak olvasás): Businesses whose name matches, newest first.
  - `query` (string, kötelező): Part of the business name, at least 2 characters
  - `limit` (integer): Maximum results, 1-25 (default 10)

Példahívás:

```json
{
  "name": "identity",
  "arguments": {
    "action": "resolve",
    "host": "mybusiness.uk.to.co"
  }
}
```

### `companies` — Manage your businesses

Read and update the businesses the connected account owns, drafts included. Needs the person to sign in (OAuth) or an agent token; only the owning account can read or change a record.

- `list` (bejelentkezés, hatókör: `companies:read`, csak olvasás): Every business the account owns, with its record key and publish status.
- `get` (bejelentkezés, hatókör: `companies:read`, csak olvasás): One business the account owns, by record key.
  - `domain` (string, kötelező): The record key of a company you own, as returned by companies list (the `domain` field)
- `update` (bejelentkezés, hatókör: `companies:write`, adatokat módosít): Change profile fields and publish the page again. Fields you leave out keep their value; an empty string or null clears one. A registered company takes its official name from the company register, so its name cannot be changed; set informal_name instead.
  - `domain` (string, kötelező): The record key of a company you own, as returned by companies list (the `domain` field)
  - `name` (string): The name of a business that is not registered. Refused for a registered company
  - `informal_name` (string): A shorter everyday name. An empty string or null clears it
  - `description` (string): What the business does, up to 2000 characters. An empty string or null clears it
  - `website_url` (string): The business website, a full https:// URL. An empty string or null clears it
  - `email` (string): A public contact email. A new address is shown on the page only after its owner confirms it from a link emailed to it; the old one stays until then. An empty string or null clears it
  - `phones` (object): Phone numbers by kind; kinds you leave out keep their value. Whether to.co verified a number is read-only
  - `links` (object): Links shown as actions on the page; links you leave out keep their value
  - `keywords` (string): Search keywords, up to 1000 characters. An empty string or null clears it
  - `category` (string): The business category shown on the page, e.g. Bakery. An empty string or null clears it
  - `vat_registration_number` (string): An optional VAT, GST or other tax registration number for the company's home country. Up to 100 characters; upper-cased, and anything but letters and digits removed. Where the country has a rule (the EU, the UK, Switzerland, Norway, Australia, New Zealand, Canada, India) its format and check digit are checked and a number that fails is refused; EU and UK numbers are saved with their country prefix. An empty string or null clears it
  - `contact_preferences` (object): How the business prefers to be contacted by to.co: true or false for email, sms, post and tel
  - `social_links` (object): Social profiles by network (linkedin, x, instagram, facebook, youtube, tiktok, pinterest, vimeo, snapchat, clubhouse): a profile link, or a handle for x and instagram. An empty string or null removes one

Példahívás:

```json
{
  "name": "companies",
  "arguments": {
    "action": "list"
  }
}
```

### `locations` — Manage your trading locations

Read the locations of a business the connected account owns, and set the description, opening hours, phone numbers and social profiles of its trading locations. These changes keep a location verified. The registered office comes from the company register and cannot be changed here; moving an address needs new proof, in the to.co app.

- `list` (bejelentkezés, hatókör: `companies:read`, csak olvasás): Every location of a business you own, with its record key, kind (registered or trading), hours, phones and profiles.
  - `domain` (string, kötelező): The record key of a company you own, as returned by companies list (the `domain` field)
- `update` (bejelentkezés, hatókör: `companies:write`, adatokat módosít): Set the description, opening hours, special hours, phone numbers or social profiles of a trading location and publish the page again. Hours replace the current ones; fields you leave out keep their value. Phone numbers are saved as international numbers; the answer's checks say what was changed, and a value that cannot be accepted is refused, naming the field.
  - `domain` (string, kötelező): The record key of a company you own, as returned by companies list (the `domain` field)
  - `location` (string, kötelező): The record key of a trading location, as returned by locations list (the `domain` field)
  - `description` (string): What this location offers: its own services, products and benefits, in plain words (no name, address, phone, email, links or prices; they are checked and removed). An empty string or null clears it
  - `normal_hours` (array): Weekly opening hours, replacing the current ones: one entry per slot, up to 4 a day; a day with no entry or open false is closed. [] or null clears them
  - `special_hours` (array): Holiday and closure hours that replace the weekly hours on their date, replacing the current list. [] or null clears them
  - `phones` (object): Phone numbers by kind; kinds you leave out keep their value. Whether to.co verified a number is read-only
  - `social_links` (object): Social profiles by network (linkedin, x, instagram, facebook, youtube, tiktok, pinterest, vimeo, snapchat, clubhouse): a profile link, or a handle for x and instagram. An empty string or null removes one

Példahívás:

```json
{
  "name": "locations",
  "arguments": {
    "action": "list",
    "domain": "yxpx6pdx.uk.to.co"
  }
}
```

### `help` — Connection and usage help

Check this connection and read the usage guide.

- `whoami` (bárki, csak olvasás): Whether this connection is signed in, and which tools and actions it can use.
- `guide` (bárki, csak olvasás): The usage guide as Markdown (also the resource toco://guide).

Példahívás:

```json
{
  "name": "help",
  "arguments": {
    "action": "whoami"
  }
}
```

## Erőforrások

- `toco://guide` (text/markdown): How to look businesses up and keep your own profile current, with examples.
- `toco://identity/{host}` (application/json): The published record at a to.co address, as JSON. Example: toco://identity/mybusiness.uk.to.co

## Promptok

- `look_up_business`: Find a business on to.co by its to.co address, website or name, and summarize its record. Argumentumok: `business`.
- `review_my_profile`: Read a business you own and suggest clearer wording for its public profile. Changes nothing until you confirm. Argumentumok: `domain`.

## Hibák

Az asszisztens által javítható hívás hibának jelölt eszközeredményként érkezik vissza, állandó kóddal kezdődve, és megmondva, mit kell módosítani:

- `invalid_arguments`: Egy argumentum hiányzik, tartományon kívüli vagy ismeretlen (a mezőnevek snake_case-ek), vagy a művelet ismeretlen.
- `not_found`: Egyetlen közzétett vállalkozás sem egyezik, vagy az Ön egyetlen vállalkozásának vagy telephelyének sincs ilyen adatlapkulcsa.
- `unauthenticated`: A művelethez bejelentkezés kell (csak az alábbi HTTP 401-re nem reagáló ügyfeleknél látható).
- `insufficient_scope`: A kapcsolat nem kapott engedélyt erre a műveletre, például módosításra, ha csak az olvasás volt engedélyezve.

A bejelentkezés nélküli cég- vagy telephelyhívás HTTP 401-et kap egy WWW-Authenticate fejléccel, amely a kiszolgáló védett erőforrás-metaadataira mutat, így tudja az asszisztens, hogy el kell kezdenie a bejelentkezést. Az Ön által engedélyezettől eltérő művelet HTTP 403-at kap error=insufficient_scope értékkel és a kérendő hatókörrel. Az érvénytelen, lejárt vagy visszavont token HTTP 401-et kap, mielőtt bármely eszköz futna; soha nem kezeljük token nélküliként. A túl sok kérés HTTP 429-et kap Retry-After fejléccel.

## Korlátok

- Percenként 120 kérés ügynöktokenenként, vagy IP-címenként token nélkül.
- A kérések törzse legfeljebb 1024 KB lehet.
- A keresés hívásonként legfeljebb 25 vállalkozást ad vissza.

## Felderítés

- Kiszolgálókártya: https://mcp.to.co/.well-known/mcp.json
- MCP Registry-bejegyzés (co.to/mcp): https://mcp.to.co/server.json
- Védett erőforrás metaadatai (RFC 9728): https://mcp.to.co/.well-known/oauth-protected-resource
- Engedélyezési kiszolgáló metaadatai (RFC 8414): https://my.to.co/.well-known/oauth-authorization-server

## Adatok és adatvédelem

A lekérdezések csak közzétett adatlapokat adnak vissza, ugyanazokat a tényeket, mint a vállalkozás nyilvános oldala. A kiszolgáló naplózza, melyik eszköz és művelet futott, sikerült-e, és mennyi ideig tartott, argumentumok és adatlaptartalom nélkül. Amikor asszisztenst csatlakoztat, a to.co nyilvántartja a kapcsolatot (az alkalmazás nevét, amit engedélyezett, mikor jött létre, és mikor használták utoljára), amely a leválasztás után is biztonsági nyilvántartásként megmarad.

## Következő lépések

- [Olvassa el a bevezető bejegyzést](https://to.co/en-us/blog/mcp-server)
- [Kezdés](https://my.to.co/claim)
