**MCPサーバー** · [API](https://to.co/ja-jp/docs/api?format=md)

# to.co MCPサーバー

AIアシスタントがto.coで公開されている事業レコードを調べ、自分の事業プロフィールを最新に保てます。事業者の検索は無料で、ログインは不要です。

[アシスタントを接続する](#connect) · [ツール](#tools)

- サーバーURL: `https://mcp.to.co/mcp`
- トランスポート: Streamable HTTP（MCPプロトコルのリビジョン2026-07-28, 2025-11-25）

<a id="connect"></a>
## アシスタントを接続する

アシスタントにサーバー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.

```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.

## ログイン

identityツールとhelpツールはログイン不要です。companiesツールとlocationsツールはアカウントが所有する事業を扱うため、アシスタントがお客様として動作する必要があります。方法は2つあります。

to.coでログイン（OAuth）。アシスタントが初めてcompaniesツールまたはlocationsツールを使うと、サーバーがログインが必要だと応答し、アシスタントがto.coのページを開きます。そこでログインし、アシスタントが求めている内容（事業の読み取りと公開プロフィールの変更）を確認できます。変更のチェックは外せます。その後、アシスタントは1時間有効で自動更新されるトークンを受け取ります。接続は「ログインとセキュリティ」ページでいつでも解除できます。これはMCPのログイン（OAuth）に対応したアシスタントで使えます。

または、MCPのログインに対応していないスクリプトやアシスタントでは、エージェントトークンを使います。my.to.coの「ログインとセキュリティ」ページで作成してください。有効期間は90日で、toco_at_で始まり、companiesツールとlocationsツールでできることをすべて行え、同じページで取り消せます。Authorization: Bearer toco_at_…として送信してください。パスワードと同じように扱ってください。Webページからのトークンは拒否されます。どちらの方法でも、サーバーは呼び出しのたびに所有者を確認し、他のアカウントの事業は「見つかりません」として扱われます。

[連携済みのアプリとトークンを管理](https://my.to.co/account/security)

<a id="business"></a>
## 事業ごとの専用サーバー

to.coで公開されているすべての事業には、それぞれ専用のMCPサーバーもあります。アドレスは事業自身のアドレスの末尾に/mcpを付けたもので、たとえばhttps://mybusiness.uk.to.co/mcpです。mcp.to.coとは別のサーバーで、その1つの事業に関する独自のツールを備えています。事業ページで公開している内容（どんな事業か、連絡方法、営業日時と場所、AIアシスタントに許可していること）、事業が受け付けている場合のメッセージ、そしてオーナー向けのツールです。どのツールもほかの事業を検索することはなく、アドレスを引数に取ることもありません。事業についての問い合わせは無料で、ログインも不要です。各事業のサーバーは、その事業自身のアドレスの/mcp/docsに、読み手の言語で説明されています。事業ページからそこへリンクしており、事業のllms.txtとLinkヘッダー（rel="service-desc"）がサーバーカード/.well-known/mcp.jsonを指しています。

接続するには、/mcpで終わる事業のアドレスを、AIアシスタントにカスタムコネクタまたはMCPサーバーとして追加してください。ログインは「ログイン」の項で説明しているとおりに行い、接続はその事業専用です。ほかの事業やmcp.to.co用のトークンは拒否されます。オーナーは、my.to.coの事業の「AIアシスタント」タブでこのアドレスを確認できます。

事業の検索は、ログインの有無にかかわらず無料です。呼び出し元（トークン、またはトークンがない場合はIPアドレス）ごとに、各事業のサーバーで1時間あたり600回まで検索できます。ログインが必要な呼び出しは、呼び出した人の負担になります。オーナーのアカウントは、どのプランでも事業の毎月のAPIクレジットを使います。それ以外の人には、すべての事業を通じた個人の上限があり、1時間あたり60回、1か月あたり500回です。月の500回を超えると、その人のアカウントでto.coに登録している事業があればその事業の毎月のAPIクレジットから支払われます。ない場合は、翌月1日まで呼び出しが拒否されます。拒否はHTTP 429で返され、事業の月の上限に達した場合はcredits_exhausted、個人の月の上限に達した場合はallowance_exhausted、1時間の上限に達した場合はRetry-After付きのrate_limitedです。

ProプランとGrowプランでは、オーナーはAIアシスタントがmessagesツールで事業にメッセージを送ることを許可できます。送信できるのは、AIアシスタントが代理で動いている本人がメッセージを確認して送信を求めた場合のみで、本人の名前と連絡先が添えられます。オーナーがオンにするまではオフです。

<a id="tools"></a>
## ツール

どの接続にも以下の4つのツールがあり、ログイン済みのアカウントには書類、取引先、メッセージ用のツールもあります。それぞれ、何をするかを示すaction引数と、そのアクションに必要な引数を受け取ります。引数と結果のフィールド名は、to.co APIと同じくsnake_caseです。結果はすべてJSONで、対応する出力スキーマ付きの構造化コンテンツとして返されます。営業時間は保存された形式のままです。day（日曜日の0から土曜日の6まで）またはdate（YYYY-MM-DD）、open、24時間制HH:mmのopen_timeとclose_timeで表し、閉店時刻が開店時刻より早い場合は深夜0時をまたぐことを意味します。

### `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` (誰でも, 読み取り専用): The business at a to.co address.
  - `host` (string, 必須): A to.co address, e.g. mybusiness.uk.to.co or mybusiness-bristol.biz.to.co
- `website` (誰でも, 読み取り専用): The 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/
- `search` (誰でも, 読み取り専用): Businesses whose name matches, newest first.
  - `query` (string, 必須): Part of the business name, at least 2 characters
  - `limit` (integer): Maximum results, 1-25 (default 10)

呼び出し例:

```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` (ログイン、スコープ`companies:read`, 読み取り専用): Every business the account owns, with its record key and publish status.
- `get` (ログイン、スコープ`companies:read`, 読み取り専用): One 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)
- `update` (ログイン、スコープ`companies:write`, データを変更): 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, 必須): 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

呼び出し例:

```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` (ログイン、スコープ`companies:read`, 読み取り専用): Every 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)
- `update` (ログイン、スコープ`companies:write`, データを変更): 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, 必須): 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

呼び出し例:

```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` (誰でも, 読み取り専用): Whether this connection is signed in, and which tools and actions it can use.
- `guide` (誰でも, 読み取り専用): The usage guide as Markdown (also the resource toco://guide).

呼び出し例:

```json
{
  "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`。

## エラー

AIアシスタントが修正できる呼び出しは、エラーとしてマークされたツール結果として返されます。結果は固定のコードで始まり、何を変更すればよいかを示します。

- `invalid_arguments`: 引数が不足している、範囲外、または不明です（フィールド名はsnake_caseです）。あるいはアクションが不明です。
- `not_found`: 一致する公開済みの事業がないか、そのレコードキーを持つ事業や所在地を所有していません。
- `unauthenticated`: このアクションにはログインが必要です（下記のHTTP 401に対応しないクライアントでのみ表示されます）。
- `insufficient_scope`: この接続ではこのアクションが許可されていません。たとえば、読み取りのみ許可されているのに変更しようとした場合です。

ログインせずにcompaniesまたはlocationsを呼び出すと、HTTP 401が返され、WWW-Authenticateヘッダーがサーバーの保護リソースメタデータを指します。AIアシスタントはこれを見てログインを開始します。許可した範囲外のアクションには、error=insufficient_scopeと要求すべきスコープを含むHTTP 403が返されます。無効、期限切れ、または取り消されたトークンには、ツールが実行される前にHTTP 401が返されます。トークンなしとして扱われることはありません。リクエストが多すぎる場合は、Retry-Afterヘッダー付きのHTTP 429が返されます。

## 上限

- エージェントトークンごと（トークンがない場合はIPアドレスごと）に1分あたり120リクエスト。
- リクエスト本文は1024 KBまで。
- 検索は1回の呼び出しで最大25件の事業を返します。

## 検出

- サーバーカード: https://mcp.to.co/.well-known/mcp.json
- MCP Registryのエントリー（co.to/mcp）: https://mcp.to.co/server.json
- 保護リソースメタデータ（RFC 9728）: https://mcp.to.co/.well-known/oauth-protected-resource
- 認可サーバーメタデータ（RFC 8414）: https://my.to.co/.well-known/oauth-authorization-server

## データとプライバシー

検索で返されるのは公開済みのレコードのみで、事業の公開ページと同じ情報です。サーバーは、どのツールとアクションが実行されたか、成功したかどうか、かかった時間を記録しますが、引数やレコードの内容は記録しません。AIアシスタントを接続すると、to.coは接続の記録（アプリ名、許可した内容、作成日時と最終利用日時）を保持します。この記録は、接続を解除した後もセキュリティ記録として残ります。

## 次のステップ

- [リリースのお知らせを読む](https://to.co/en-us/blog/mcp-server)
- [はじめる](https://my.to.co/claim)
