خادم MCP في to.co
اسمح لمساعد ذكاء اصطناعي بالبحث عن سجلات الأعمال المنشورة على 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)
- 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.
تسجيل الدخول
لا تحتاج أداتا الهوية والمساعدة إلى تسجيل دخول. أما أداتا الشركات والمواقع فتعملان على الأنشطة التجارية التي يملكها حسابك، لذا يجب أن يعمل المساعد باسمك. هناك طريقتان.
تسجيل الدخول باستخدام to.co (OAuth). عندما يستخدم المساعد أداة الشركات أو المواقع لأول مرة، يرد الخادم بأنه يحتاج إلى تسجيل دخول، فيفتح المساعد صفحة في to.co تسجّل فيها الدخول وترى ما يطلبه: قراءة أنشطتك التجارية، وتغيير ملفاتها العامة. يمكنك إلغاء تحديد التغييرات. ثم يحصل على رمز يدوم ساعة ويتجدد تلقائيًا؛ ويمكنك قطع اتصاله في أي وقت من صفحة «تسجيل الدخول والأمان». يعمل هذا في المساعدين الذين يدعمون تسجيل الدخول في MCP (OAuth).
أو استخدم رمز وكيل، للنصوص البرمجية والمساعدين الذين لا يدعمون تسجيل الدخول في MCP. أنشئ واحدًا من صفحة «تسجيل الدخول والأمان» في my.to.co. يدوم 90 يومًا، ويبدأ بـ toco_at_، ويستطيع كل ما تفعله أداتا الشركات والمواقع، ويمكنك إلغاؤه من هناك. أرسله كـ 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، في علامة تبويب «مساعدو الذكاء الاصطناعي» للنشاط التجاري.
البحث عن نشاط تجاري لا يكلّف شيئًا، سواء سُجّل الدخول أم لا: يمكن لكل مستدعٍ (رمز، أو عنوان IP دون رمز) إجراء 600 عملية بحث في الساعة على خادم كل نشاط تجاري. الطلب الذي يحتاج إلى تسجيل دخول يدفع مقابله من يجريه. يستهلك حساب المالك أرصدة API الشهرية للنشاط التجاري، في كل الخطط. أما أي شخص آخر فله حصته الخاصة عبر كل الأنشطة التجارية: 60 طلب في الساعة و500 في الشهر. بعد تجاوز 500 الشهرية، يدفع نشاط تجاري يملكه حسابه على to.co من أرصدة API الشهرية الخاصة به؛ وإن لم يوجد، تُرفض الطلبات حتى اليوم الأول من الشهر. حالات الرفض هي HTTP 429: credits_exhausted عند استنفاد شهر النشاط التجاري، وallowance_exhausted لشهر الشخص، وrate_limited مع Retry-After للساعة.
في Pro وGrow، يمكن للمالك السماح للمساعدين بإرسال رسالة إلى النشاط التجاري بأداة الرسائل، بعد أن يطّلع عليها الشخص الذي يعمل المساعد لصالحه ويطلب إرسالها، مع اسمه وبيانات الاتصال الخاصة به. تبقى متوقفة حتى يفعّلها المالك.
الأدوات
تتوفر لكل اتصال الأدوات الأربع أدناه؛ وتحصل الحسابات المسجّلة الدخول أيضًا على أدوات للمستندات والشركاء التجاريين والرسائل. تأخذ كل منها معامل action يحدد ما يجب فعله، إضافة إلى المعاملات التي يحتاجها ذلك الإجراء. أسماء حقول المعاملات والنتائج بصيغة snake_case، مثل API في to.co. كل نتيجة بصيغة JSON، تُعاد كمحتوى منظّم مع مخطط إخراج مطابق. تحتفظ ساعات العمل بصيغتها المخزّنة: day (من 0 للأحد إلى 6 للسبت) أو date (YYYY-MM-DD)، وopen، وopen_time وclose_time بنظام 24 ساعة HH:mm، ووقت الإغلاق الأبكر من وقت الفتح يمتد إلى ما بعد منتصف الليل.
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. |
| أي شخص للقراءة فقط |
website | The businesses whose website is on this hostname. A website can belong to more than one business, so this returns a list. |
| أي شخص للقراءة فقط |
search | Businesses whose name matches, newest first. |
| أي شخص للقراءة فقط |
مثال على الاستدعاء
{
"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 | Every business the account owns, with its record key and publish status. | لا شيء | تسجيل الدخول، النطاق companies:readللقراءة فقط |
get | One business the account owns, by record key. |
| تسجيل الدخول، النطاق companies:readللقراءة فقط |
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. |
| تسجيل الدخول، النطاق 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.
| الإجراء | ما يفعله | المعاملات | الوصول |
|---|---|---|---|
list | Every location of a business you own, with its record key, kind (registered or trading), hours, phones and profiles. |
| تسجيل الدخول، النطاق companies:readللقراءة فقط |
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. |
| تسجيل الدخول، النطاق 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.
| الإجراء | ما يفعله | المعاملات | الوصول |
|---|---|---|---|
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). | لا شيء | أي شخص للقراءة فقط |
مثال على الاستدعاء
{
"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— لم يُسمح للاتصال بهذا الإجراء، مثل تغيير بينما سُمح بالقراءة فقط.
يتلقى استدعاء أداة الشركات أو المواقع دون تسجيل دخول HTTP 401 مع ترويسة WWW-Authenticate تشير إلى بيانات المورد المحمي الوصفية للخادم، وهكذا يعرف المساعد أنه يجب أن يبدأ تسجيل الدخول. ويتلقى الإجراء الخارج عما سمحت به HTTP 403 مع error=insufficient_scope والنطاق الذي يجب طلبه. ويتلقى الرمز غير الصالح أو المنتهي أو الملغى HTTP 401 قبل تشغيل أي أداة؛ ولا يُعامل أبدًا كأنه لا يوجد رمز. وتتلقى الطلبات الكثيرة جدًا HTTP 429 مع ترويسة Retry-After.
الحدود
- 120 طلب في الدقيقة لكل رمز وكيل، أو لكل عنوان IP دون رمز.
- محتوى الطلبات حتى 1024 KB.
- يعيد البحث حتى 25 نشاط تجاري في كل استدعاء.
الاكتشاف
- بطاقة الخادم —
https://mcp.to.co/.well-known/mcp.json - قيد في سجل MCP (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 - llms.txt لهذا الموقع
البيانات والخصوصية
لا تعيد عمليات البحث إلا السجلات المنشورة، الحقائق نفسها الموجودة في صفحة النشاط التجاري العامة. يسجّل الخادم الأداة والإجراء اللذين جرى تشغيلهما، وما إذا نجحا، والمدة المستغرقة، دون معاملات ودون محتوى السجلات. عندما تربط مساعدًا، يحتفظ to.co بسجل للاتصال (اسم التطبيق، وما سمحت به، ووقت إنشائه وآخر استخدام له)، ويبقى كسجل أمني بعد قطع اتصاله.