نحوهٔ افزودن اتصال‌دهندهٔ MCP (سرور MCP) به Tesseract

Tesseract از هر سرور MCP، از طریق stdio، HTTP یا SSE، و همچنین سرورهای موجود در فهرست رسمی MCP پشتیبانی می‌کند. کافی است یک‌بار آن را در تنظیمات ← افزونه‌ها ← اتصال‌دهنده‌ها، با نشانی، فرمان راه‌اندازی یا تنظیماتش به‌صورت JSON اضافه کنید. سپس هر ۱۴ چارچوب عامل در Tesseract می‌توانند از ابزارهای آن استفاده کنند.

با Tesseract 0.12.5 بررسی شده است.

چطور یک سرور MCP به Tesseract اضافه کنم؟

به تنظیمات ← افزونه‌ها ← اتصال‌دهنده‌ها بروید و اطلاعات سرور را در یکی از سه قالب به Tesseract بدهید. Tesseract پیش از افزودن، جزئیات آن را به شما نشان می‌دهد.

  1. تنظیمات ← افزونه‌ها را باز کنید و سپس به زبانهٔ اتصال‌دهنده‌ها بروید.
  2. یکی از موارد زیر را در کادر بالای صفحه جای‌گذاری کنید و سپس افزودن را بزنید:
    • نشانی، برای سروری در وب؛ پیوندی با http یا https، مثل https://mcp.example.com/mcp.
    • فرمان، برای سروری که از طریق stdio روی رایانهٔ شما اجرا می‌شود؛ مثل npx -y @acme/notes-mcp.
    • تنظیمات آن به‌صورت JSON: فرمان، آرگومان‌ها و محیط اجرای آن.
  3. اطلاعاتی را که Tesseract نشان می‌دهد بررسی کنید. برای فرمان، کل فرمانی را که اجرا می‌شود می‌بینید؛ تا وقتی اجازه ندهید، چیزی اجرا نمی‌شود.
  4. برای افزودن، دکمهٔ پایین صفحه را بزنید: برای فرمان اجازه و افزودن و برای نشانی افزودن اتصال‌دهنده. تا وقتی دکمه را نزنید، چیزی اضافه نمی‌شود.

می‌توانم پیکربندی JSON را، مثلاً از README سرور، جای‌گذاری کنم؟

بله. Tesseract تنظیمات یک سرور را با فیلد url یا command می‌خواند، یا کل بخشی را که زیر mcpServers آمده است. همچنین سرورها را زیر servers، mcp یا mcp_servers پیدا می‌کند.

مثلاً برای سروری که روی رایانهٔ شما اجرا می‌شود:

{ "mcpServers": { "notes": { "command": "npx", "args": ["-y", "@acme/notes-mcp"] } } }

اگر در تنظیمات چند سرور تعریف شده باشد، Tesseract همه را فهرست می‌کند تا انتخاب کنید کدام را اضافه کنید.

چطور سروری را از فهرست رسمی MCP اضافه کنم؟

در زبانهٔ اتصال‌دهنده‌ها، کنار کادر، مرور فهرست را بزنید و سرور را از آنجا اضافه کنید.

  1. تنظیمات ← افزونه‌ها ← اتصال‌دهنده‌ها را باز کنید.
  2. مرور فهرست را بزنید. سرورهای فهرست رسمی MCP نمایش داده می‌شوند و می‌توانید با نام جست‌وجو کنید.
  3. روی افزودن برای مورد دلخواهتان بزنید. سپس همان مراحلی را می‌بینید که برای نشانی یا فرمانِ جای‌گذاری‌شده طی می‌شود؛ تا وقتی نگویید، چیزی اضافه نمی‌شود.

با Claude Code، Codex، Gemini CLI و OpenCode کار می‌کند؟

بله. صفحهٔ هر چارچوب در این سایت، «ابزارهای Tesseract و سرورهای MCP شما» را در فهرست موارد پشتیبانی‌شده آورده است؛ این شامل هر ۱۴ چارچوب می‌شود: Claude Code، OpenAI Codex، OpenCode، Gemini CLI، Antigravity CLI، Kimi Code، Qwen Code، MiniMax Code، CodeBuddy، Grok Build، Cursor، Hermes Agent، OpenClaw و NanoClaw. کافی است اتصال‌دهنده را یک‌بار در Tesseract اضافه کنید، نه برای هر چارچوب جداگانه. هر گفت‌وگو چارچوب خودش را انتخاب می‌کند، بنابراین گفت‌وگوهای مختلف می‌توانند از چارچوب‌های متفاوتی استفاده کنند.

چطور برای اتصال‌دهنده‌ام دکمهٔ «افزودن به Tesseract» بسازم؟

از ابزار رایگان در tesseract.dev/connect/ استفاده کنید. این ابزار یک نشان در Markdown برای README و یک پیوند ساده به شما می‌دهد.

  1. tesseract.dev/connect/ را باز کنید.
  2. نام اتصال‌دهنده‌تان را وارد کنید.
  3. نشانی سرورتان یا تنظیمات JSON آن را جای‌گذاری کنید.
  4. Markdown را در README یا پیوند را کپی کنید.

نشان به صفحه‌ای در tesseract.dev پیوند می‌دهد، نه مستقیم به برنامه؛ چون GitHub پیوندهایی را که از نوع http(s) نیستند حذف می‌کند. نشانی حداکثر می‌تواند ۲٬۰۴۸ نویسه باشد. تنظیمات باید یک شیء JSON با حداکثر ۲۰٬۰۰۰ نویسه باشد. تنظیمات فقط به‌صورت کدگذاری‌شده (base64url) در خود پیوند نوشته می‌شوند؛ پس کلیدها و توکن‌های واقعی را در آن‌ها قرار ندهید.

وقتی کسی روی دکمه کلیک می‌کند چه اتفاقی می‌افتد؟

ابتدا اتصال‌دهنده‌تان را در tesseract.dev می‌بینند و چیزی به‌خودی‌خود باز نمی‌شود.

  1. در صفحه توضیح داده می‌شود اتصال‌دهنده چیست: نشانی وبی که به آن وصل می‌شود یا فرمانی که اجرا می‌کند، به‌طور کامل نوشته شده است.
  2. این صفحه گزینهٔ باز کردن در Tesseract را نشان می‌دهد و برای کسانی که برنامه را ندارند، گزینهٔ دریافت Tesseract را ارائه می‌کند.
  3. گزینه «باز کردن در Tesseract» مسیر تنظیمات ← افزونه‌ها ← اتصال‌دهنده‌ها را باز می‌کند و اتصال‌دهنده از قبل در کادر قرار دارد و با عبارت «این مورد از یک پیوند آمده است» مشخص شده است.
  4. Tesseract پیش از افزودن هر چیزی، دوباره آن را نشان می‌دهد و پیش از اجرای هر چیزی اجازه می‌گیرد.

اگر نتوان اطلاعات url= یا config= را از پیوند خواند، پیام «این پیوند نام اتصال‌دهنده‌ای را مشخص نمی‌کند» نمایش داده می‌شود.

آیا این کار مثل استفاده از Tesseract در Claude یا ChatGPT است؟

نه. این راهنما سرورهای MCP دیگر را به Tesseract اضافه می‌کند؛ استفاده از Tesseract در Claude و ChatGPT روش برعکس آن است و با یک نشانی، Tesseract را به برنامه گفت‌وگویتان اضافه می‌کند.

پرسش‌ها

آیا Tesseract می‌تواند از هر سرور MCP استفاده کند؟

می‌تواند از هر سرور MCP از طریق stdio، HTTP یا SSE استفاده کند.

آیا باید سرور را جداگانه برای Claude Code و Codex راه‌اندازی کنم؟

نه. یک‌بار آن را از مسیر تنظیمات ← افزونه‌ها ← اتصال‌دهنده‌ها اضافه می‌کنید و همهٔ چارچوب‌ها در Tesseract می‌توانند از آن استفاده کنند.

آیا می‌توانم JSON مربوط به mcpServers را از یک README جای‌گذاری کنم؟

بله. Tesseract تنظیمات یک سرور یا کل بلوک mcpServers را می‌خواند.

سرورهای فهرست رسمی MCP را از کجا پیدا کنم؟

در مسیر تنظیمات ← افزونه‌ها ← اتصال‌دهنده‌ها، زیر عنوان «مرور فهرست».

آیا پیوند «افزودن به Tesseract» اتصال‌دهنده را خودکار اضافه می‌کند؟

نه. Tesseract پیش از افزودن هر چیزی، دوباره آن را به شما نشان می‌دهد و پیش از اجرای هر چیزی اجازه می‌گیرد.

راهنماهای بیشتر