42

MCP

راه‌اندازی MCP طرحک در Cursor، Claude Code، Codex و OpenCode.

با MCP طرحَک، ایجنت می‌تواند کامپوننت‌ها را جست‌وجو کند و دستور نصب بدهد. آدرس سرور برای همهٔ کلاینت‌ها یکی است:

https://tarhak.ir/api/mcp

نصب با CLI

در ریشهٔ پروژه:

npx @tarhak/cli@latest mcp

CLI تشخیص می‌دهد Cursor، Claude Code، Codex یا OpenCode هستید و کانفیگ همان کلاینت را می‌نویسد (پوشهٔ لازم را هم می‌سازد). اگر چیزی مشخص نباشد، Cursor + Claude + Codex را آماده می‌کند.

برای Cursor بعد از آن Settings → MCP و سوئیچ tarhak را روشن کنید.

نصب دستی

اگر ترجیح می‌دهید خودتان کانفیگ کنید، بخش کلاینت را باز کنید:

ابزارها

ابزارکار
tarhak_list_componentsلیست کامپوننت‌ها
tarhak_search_componentsجست‌وجو
tarhak_get_componentجزئیات و وابستگی‌ها
tarhak_install_commandدستور نصب CLI

نصب کامپوننت

MCP فقط دستور را پیشنهاد می‌دهد؛ در ترمینال پروژه اجرا کنید:

npx @tarhak/cli@latest add <slug>

لوکال (اختیاری)

اگر next dev را بالا آورده‌اید:

http://localhost:3000/api/mcp

Stdio از کلون ریپو:

npm run mcp:install
{

  "mcpServers": {

    "tarhak": {

      "command": "npx",

      "args": ["tsx", "mcp/tarhak-mcp-server/src/index.ts"],

      "env": {

        "TARHAK_SITE_URL": "https://tarhak.ir"

      }

    }

  }

}

عیب‌یابی

مشکلکار
Connected نیستURL را دقیق کپی کنید؛ Reload یا ری‌استارت کلاینت
Claude Code رد می‌کنددر JSON حتماً type برابر http باشد
ابزار صدا زده نمی‌شودحالت Agent؛ یک‌بار لیست MCP را رفرش کنید
کامپوننت پیدا نمی‌شودفقط آیتم‌های منتشرشده در /r