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 Eszközök
- Kiszolgáló URL-je
https://mcp.to.co/mcp- Átvitel
- Streamable HTTP (MCP-protokoll változatai: 2026-07-28, 2025-11-25)
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)
- Open Settings, then Connectors, and choose Add custom connector.
- Name it to.co and enter https://mcp.to.co/mcp as the URL.
- 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
- 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.
claude mcp add --transport http toco https://mcp.to.co/mcp
Cursor
- 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.
{
"mcpServers": {
"toco": {
"url": "https://mcp.to.co/mcp"
}
}
}
VS Code
- 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.
{
"servers": {
"toco": {
"type": "http",
"url": "https://mcp.to.co/mcp"
}
}
}
ChatGPT
- In Settings, open Apps and connectors and turn on developer mode under Advanced.
- Create a connector with https://mcp.to.co/mcp as the server URL and OAuth as the authentication.
Windsurf
- 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.
{
"mcpServers": {
"toco": {
"serverUrl": "https://mcp.to.co/mcp",
"headers": {
"Authorization": "Bearer toco_at_…"
}
}
}
}
Any other client
- Use Streamable HTTP at https://mcp.to.co/mcp.
- 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
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.
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.
| Művelet | Mit csinál | Argumentumok | Hozzáférés |
|---|---|---|---|
resolve | The business at a to.co address. |
| Bárki Csak olvasás |
website | The businesses whose website is on this hostname. A website can belong to more than one business, so this returns a list. |
| Bárki Csak olvasás |
search | Businesses whose name matches, newest first. |
| Bárki Csak olvasás |
Példahívás
{
"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.
| Művelet | Mit csinál | Argumentumok | Hozzáférés |
|---|---|---|---|
list | Every business the account owns, with its record key and publish status. | Nincs | Bejelentkezés, hatókör: companies:readCsak olvasás |
get | One business the account owns, by record key. |
| Bejelentkezés, hatókör: companies:readCsak olvasás |
update | 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. |
| Bejelentkezés, hatókör: companies:writeAdatokat módosít |
Példahívás
{
"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.
| Művelet | Mit csinál | Argumentumok | Hozzáférés |
|---|---|---|---|
list | Every location of a business you own, with its record key, kind (registered or trading), hours, phones and profiles. |
| Bejelentkezés, hatókör: companies:readCsak olvasás |
update | 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. |
| Bejelentkezés, hatókör: companies:writeAdatokat módosít |
Példahívás
{
"name": "locations",
"arguments": {
"action": "list",
"domain": "yxpx6pdx.uk.to.co"
}
}
help — Connection and usage help
Check this connection and read the usage guide.
| Művelet | Mit csinál | Argumentumok | Hozzáférés |
|---|---|---|---|
whoami | Whether this connection is signed in, and which tools and actions it can use. | Nincs | Bárki Csak olvasás |
guide | The usage guide as Markdown (also the resource toco://guide). | Nincs | Bárki Csak olvasás |
Példahívás
{
"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 - llms.txt ehhez az oldalhoz
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.