to.co 홈

to.co MCP 서버

AI 어시스턴트가 to.co에 게시된 비즈니스 레코드를 조회하고, 내 비즈니스 프로필을 최신으로 유지하게 하세요. 비즈니스 조회는 무료이며 로그인이 필요 없습니다.

어시스턴트 연결하기 도구

서버 URL
https://mcp.to.co/mcp
전송 방식
Streamable HTTP(MCP 프로토콜 개정판 2026-07-28, 2025-11-25)

어시스턴트 연결하기

어시스턴트에 서버 URL을 추가하세요. 조회는 바로 작동합니다. 내 비즈니스를 관리하게 하려면 요청할 때 to.co에 로그인하세요. 방법은 로그인 항목에 나와 있습니다.

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.
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.
{
  "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.
{
  "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.
{
  "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.

로그인

identity 도구와 help 도구는 로그인이 필요 없습니다. companies 도구와 locations 도구는 내 계정이 소유한 비즈니스에서 작동하므로 어시스턴트가 나를 대신해 작업해야 합니다. 방법은 두 가지입니다.

to.co로 로그인(OAuth). 어시스턴트가 companies 또는 locations 도구를 처음 사용하면 서버가 로그인이 필요하다고 응답하고, 어시스턴트가 to.co 페이지를 엽니다. 거기서 로그인하고 요청 내용(비즈니스 읽기, 공개 프로필 변경)을 확인합니다. 변경 권한은 체크 해제할 수 있습니다. 그러면 어시스턴트는 1시간 동안 유효하고 스스로 갱신되는 토큰을 받습니다. 로그인 및 보안 페이지에서 언제든지 연결을 해제할 수 있습니다. MCP 로그인(OAuth)을 지원하는 어시스턴트에서 작동합니다.

또는 MCP 로그인을 지원하지 않는 스크립트와 어시스턴트에는 에이전트 토큰을 사용하세요. my.to.co의 로그인 및 보안 페이지에서 만듭니다. 토큰은 90일 동안 유효하고 toco_at_로 시작하며, companies 도구와 locations 도구가 하는 모든 일을 할 수 있고, 같은 페이지에서 취소할 수 있습니다. Authorization: Bearer toco_at_… 형식으로 보내세요. 비밀번호처럼 다루세요. 웹 페이지에서 보낸 토큰은 거부됩니다. 어느 방법이든 서버는 호출할 때마다 소유권을 확인하며, 다른 계정의 비즈니스는 찾을 수 없음으로 나옵니다.

연결된 앱과 토큰 관리

비즈니스별 전용 서버

to.co에 게시된 모든 비즈니스에는 자체 주소 끝에 /mcp를 붙인 전용 MCP 서버도 있습니다(예: https://mybusiness.uk.to.co/mcp). 이 서버는 mcp.to.co와 별개이며, 해당 비즈니스 하나에 관한 자체 도구를 제공합니다. 비즈니스가 페이지에 게시하는 내용(누구인지, 연락 방법, 영업 시간과 장소, 어시스턴트에게 허용하는 작업), 비즈니스가 메시지를 받는 경우 메시지, 그리고 소유자용 도구입니다. 어떤 도구도 다른 비즈니스를 조회하지 않으며, 주소를 인수로 받지도 않습니다. 비즈니스에 관해 묻는 것은 무료이며 로그인이 필요 없습니다. 각 비즈니스의 서버는 해당 주소의 /mcp/docs에 읽는 사람의 언어로 설명되어 있습니다. 비즈니스 페이지에서 이 문서로 연결되며, 비즈니스의 llms.txt와 Link 헤더(rel="service-desc")가 서버 카드인 /.well-known/mcp.json을 가리킵니다.

연결하려면 /mcp로 끝나는 비즈니스 주소를 어시스턴트에 사용자 지정 커넥터 또는 MCP 서버로 추가하세요. 로그인은 '로그인' 항목에 설명된 대로 진행되며, 연결은 해당 비즈니스에만 적용됩니다. 다른 비즈니스나 mcp.to.co용 토큰은 거부됩니다. 소유자는 my.to.co에서 비즈니스의 AI 어시스턴트 탭에서 이 주소를 찾을 수 있습니다.

비즈니스 조회는 로그인 여부와 관계없이 무료입니다. 각 호출자(토큰, 또는 토큰이 없으면 IP 주소)는 비즈니스 서버마다 시간당 600회 조회할 수 있습니다. 로그인이 필요한 호출은 호출한 쪽이 비용을 부담합니다. 소유자 계정은 모든 요금제에서 비즈니스의 월간 API 크레딧을 사용합니다. 그 밖의 사용자는 모든 비즈니스에 걸쳐 자체 한도가 있습니다. 시간당 60회, 월 500회입니다. 월 500회를 넘으면 본인 계정이 to.co에 보유한 비즈니스의 월간 API 크레딧에서 차감되며, 그런 비즈니스가 없으면 다음 달 1일까지 호출이 거부됩니다. 거부 응답은 HTTP 429입니다. 비즈니스의 월간 한도를 모두 쓰면 credits_exhausted, 개인의 월간 한도를 모두 쓰면 allowance_exhausted, 시간당 한도를 넘으면 Retry-After와 함께 rate_limited가 반환됩니다.

Pro와 Grow 요금제에서는 소유자가 어시스턴트가 messages 도구로 비즈니스에 메시지를 보내도록 허용할 수 있습니다. 단, 어시스턴트가 대신하는 사람이 메시지를 확인하고 보내 달라고 요청해야 하며, 그 사람의 이름과 연락처가 함께 전송됩니다. 소유자가 켜기 전까지는 꺼져 있습니다.

도구

모든 연결에는 아래 네 가지 도구가 있으며, 로그인한 계정에는 문서, 거래처, 메시지용 도구도 제공됩니다. 각 도구는 수행할 작업을 지정하는 action 인수와 해당 작업에 필요한 인수를 받습니다. 인수와 결과 필드 이름은 to.co API처럼 snake_case입니다. 모든 결과는 JSON이며, 일치하는 출력 스키마와 함께 구조화된 콘텐츠로 반환됩니다. 영업시간은 저장된 형식을 그대로 유지합니다. day(일요일 0부터 토요일 6까지) 또는 date(YYYY-MM-DD), open, 24시간제 HH:mm 형식의 open_time과 close_time이며, 종료 시간이 시작 시간보다 이르면 자정을 넘겨 영업하는 것으로 봅니다.

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.

작업기능인수접근 권한
resolveThe business at a to.co address.
  • host string, 필수 A to.co address, e.g. mybusiness.uk.to.co or mybusiness-bristol.biz.to.co
누구나
읽기 전용
websiteThe businesses whose website is on this hostname. A website can belong to more than one business, so this returns a list.
  • website string, 필수 The business's own website, e.g. mybusiness.com or https://www.mybusiness.com/
누구나
읽기 전용
searchBusinesses whose name matches, newest first.
  • query string, 필수 Part of the business name, at least 2 characters
  • limit integer Maximum results, 1-25 (default 10)
누구나
읽기 전용

호출 예시

{
  "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.

작업기능인수접근 권한
listEvery business the account owns, with its record key and publish status.없음로그인, 범위 companies:read
읽기 전용
getOne business the account owns, by record key.
  • domain string, 필수 The record key of a company you own, as returned by companies list (the `domain` field)
로그인, 범위 companies:read
읽기 전용
updateChange 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, 필수 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
로그인, 범위 companies:write
데이터 변경

호출 예시

{
  "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.

작업기능인수접근 권한
listEvery location of a business you own, with its record key, kind (registered or trading), hours, phones and profiles.
  • domain string, 필수 The record key of a company you own, as returned by companies list (the `domain` field)
로그인, 범위 companies:read
읽기 전용
updateSet 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, 필수 The record key of a company you own, as returned by companies list (the `domain` field)
  • location string, 필수 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
로그인, 범위 companies:write
데이터 변경

호출 예시

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

help — Connection and usage help

Check this connection and read the usage guide.

작업기능인수접근 권한
whoamiWhether this connection is signed in, and which tools and actions it can use.없음누구나
읽기 전용
guideThe usage guide as Markdown (also the resource toco://guide).없음누구나
읽기 전용

호출 예시

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

리소스

  • 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

프롬프트

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

오류

어시스턴트가 고칠 수 있는 호출은 오류로 표시된 도구 결과로 반환되며, 고정된 코드로 시작하고 무엇을 바꿔야 하는지 알려 줍니다.

  • invalid_arguments — 인수가 없거나, 범위를 벗어나거나, 알 수 없는 인수(필드 이름은 snake_case)이거나, 알 수 없는 작업입니다.
  • not_found — 일치하는 게시된 비즈니스가 없거나, 소유한 비즈니스나 위치 중 해당 레코드 키를 가진 것이 없습니다.
  • unauthenticated — 이 작업에는 로그인이 필요합니다(아래 HTTP 401에 대응하지 않는 클라이언트에서만 표시됨).
  • insufficient_scope — 연결에 이 작업이 허용되지 않았습니다. 예를 들어 읽기만 허용했는데 변경을 요청한 경우입니다.

로그인 없이 companies 또는 locations를 호출하면 서버의 보호된 리소스 메타데이터를 가리키는 WWW-Authenticate 헤더와 함께 HTTP 401이 반환되며, 어시스턴트는 이를 보고 로그인을 시작해야 함을 알게 됩니다. 허용한 범위를 벗어난 작업은 error=insufficient_scope와 요청해야 할 범위가 담긴 HTTP 403을 받습니다. 유효하지 않거나 만료되었거나 취소된 토큰은 도구가 실행되기 전에 HTTP 401을 받으며, 토큰이 없는 것으로 취급되지 않습니다. 요청이 너무 많으면 Retry-After 헤더와 함께 HTTP 429가 반환됩니다.

한도

  • 에이전트 토큰당(토큰이 없으면 IP 주소당) 분당 120회 요청.
  • 요청 본문은 최대 1024KB.
  • 검색은 호출당 최대 25개 비즈니스를 반환합니다.

검색 및 발견

데이터 및 개인정보

조회 결과에는 비즈니스의 공개 페이지와 같은 내용, 즉 게시된 레코드만 포함됩니다. 서버는 어떤 도구와 작업이 실행되었는지, 성공했는지, 얼마나 걸렸는지만 기록하며, 인수나 레코드 내용은 기록하지 않습니다. 어시스턴트를 연결하면 to.co는 연결 기록(앱 이름, 허용한 내용, 만든 시점과 마지막 사용 시점)을 보관하며, 이 기록은 연결을 해제한 뒤에도 보안 기록으로 남습니다.

다음 단계

언어

사이트와 앱이 완전히 지원하는 언어 중에서 선택하세요.