اتصال ابزارهای AI (Connect AI Tools)

پرتو دیزاین سیستم را به‌صورت MCP server استاندارد (Model Context Protocol) منتشر می‌کند تا هر ابزار AI با یک کانفیگ کوتاه از دانش کامپوننت‌ها، قوانین RTL، توکن‌های رنگ، و قواعد دامنهٔ افکارسنجی برخوردار شود.

بسته به ابزار شما، یکی از سه مسیر زیر را انتخاب کنید:

1. MCP Server — توصیه‌شده. یک کانفیگ JSON کوتاه برای هر ابزار، نتیجه: LLM دامنه‌آگاه.
2. AGENTS.md — برای ابزارهایی که MCP صحبت نمی‌کنند یا می‌خواهید بدون نصب چیز اضافه‌ای کار کنید.
3. پلاگین Claude Code — کامل‌ترین تجربه (skills + agents + hooks)، فقط Claude Code.

۱. MCP Server — مسیر استاندارد

MCP یک پروتکل باز است که در modelcontextprotocol.io تعریف شده و توسط Claude Code، Cursor، VS Code Copilot، Windsurf، Antigravity، Cline و دیگر ابزارها پشتیبانی می‌شود.

ابزارهای موجود در MCP پرتو

پکیج @parto-system-design/mcp-server در npm منتشر شده و با npx -y بدون نصب لوکال هم کار می‌کند.

Claude Code

فایل .mcp.json را در ریشه پروژه بسازید:

{
  "mcpServers": {
    "parto": {
      "command": "npx",
      "args": ["-y", "@parto-system-design/mcp-server"]
    }
  }
}

Cursor

فایل .cursor/mcp.json را در ریشه پروژه بسازید:

{
  "mcpServers": {
    "parto": {
      "command": "npx",
      "args": ["-y", "@parto-system-design/mcp-server"]
    }
  }
}

برای اعمال در همه پروژه‌ها، همان فایل را در ~/.cursor/mcp.json قرار دهید.

VS Code (GitHub Copilot)

فایل .vscode/mcp.json را بسازید. توجه کنید که VS Code کلید servers (نه mcpServers) را استفاده می‌کند:

{
  "servers": {
    "parto": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@parto-system-design/mcp-server"]
    }
  }
}

Windsurf

تنظیمات MCP در ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "parto": {
      "command": "npx",
      "args": ["-y", "@parto-system-design/mcp-server"]
    }
  }
}

Windsurf همچنین فایل AGENTS.md ریشه پروژه را به‌طور خودکار می‌خواند (به بخش بعدی مراجعه کنید).

Google Antigravity

از v1.20.x به بعد، Antigravity پشتیبانی per-workspace MCP دارد. تنظیمات MCP را از طریق Settings → MCP اضافه کنید یا فایل کانفیگ workspace را ویرایش کنید:

{
  "mcpServers": {
    "parto": {
      "command": "npx",
      "args": ["-y", "@parto-system-design/mcp-server"]
    }
  }
}

مرجع: antigravity.google/docs/mcp

Gemini CLI

فایل ~/.gemini/settings.json را ویرایش کنید:

{
  "mcpServers": {
    "parto": {
      "command": "npx",
      "args": ["-y", "@parto-system-design/mcp-server"]
    }
  }
}

Cline / Roo

از تب MCP در پنل افزونهٔ Cline، یا مستقیماً در cline_mcp_settings.json:

{
  "mcpServers": {
    "parto": {
      "command": "npx",
      "args": ["-y", "@parto-system-design/mcp-server"]
    }
  }
}

ترنسپورت HTTP — برای IDEهای ابری و سلف-هاست

اگر از یک IDE ابری استفاده می‌کنید (Cursor cloud، Codespaces، VS Code وب) یا می‌خواهید یک نمونهٔ مشترک تیمی داشته باشید، می‌توانید سرور را به‌صورت HTTP اجرا کنید:

docker run -d --name parto-mcp -p 3333:3333 ghcr.io/dadenegar-company/parto-mcp:latest
curl http://localhost:3333/health

سپس به‌جای command/args از کلید url استفاده کنید:

{
  "mcpServers": {
    "parto": { "url": "http://localhost:3333/mcp" }
  }
}

VS Code شکل کمی متفاوت دارد:

{
  "servers": {
    "parto": { "type": "http", "url": "http://localhost:3333/mcp" }
  }
}

برای استقرار سازمانی، docker-compose.yml نمونه در packages/mcp-server/examples/ موجود است.

۲. تأیید اتصال (Verification)

پس از تنظیم MCP، ابزار را ری‌استارت کنید و این پرامپت را بفرستید:

یک کارت پروفایل اینفلوئنسر بساز که:
- MetricCard برای نرخ تعامل با category="micro" داشته باشد
- SentimentBadge با مقدار positive داشته باشد
- متن همه فارسی رسمی باشد
- از توکن‌های semantic رنگ استفاده شود (نه text-gray-500)

اگر MCP درست وصل باشد، پاسخ:

• نام دقیق EngagementRate با prop category="micro" را برمی‌گرداند (نه ساختار generic shadcn).
• از text-light و bg-surface-100 استفاده می‌کند، نه text-gray-500 و bg-white.
• تمام classها از CSS Logical Properties (ms-*، pe-*) استفاده می‌کنند.

اگر LLM به shadcn یا generic Tailwind برگشت، MCP وصل نشده است — کانفیگ JSON و ری‌استارت ابزار را دوباره بررسی کنید.

۳. AGENTS.md — فال‌بک بدون MCP

اگر ابزار شما MCP پشتیبانی نمی‌کند یا نمی‌خواهید کانفیگ اضافه‌ای بدهید، فایل AGENTS.md همراه پکیج npm منتشر می‌شود و توسط Cursor، Windsurf، Antigravity و سایر ابزارهای سازگار از مسیر node_modules خوانده می‌شود.

برای بهترین نتیجه، آن را به ریشهٔ پروژهٔ خود کپی کنید:

# پس از pnpm add @parto-system-design/ui
cp node_modules/@parto-system-design/ui/AGENTS.md ./AGENTS.md

این فایل شامل قوانین RTL، الگوی component، toolهای ساخت، و کنوانسیون‌های زبانی است.

فایل‌های اضافی برای ابزارهای خاص

برای راحتی بیشتر، فایل‌های ابزار-اختصاصی نیز در ai-context/ ریپو موجودند:

# Cursor — rules اختصاصی
cp ai-context/parto.mdc .cursor/rules/parto.mdc

# GitHub Copilot
cp ai-context/copilot-instructions.md .github/copilot-instructions.md

# Gemini CLI
cp ai-context/GEMINI.md ./GEMINI.md

# Windsurf
cp ai-context/windsurf-rule.md .windsurf/rules/parto.md

۴. مقایسه روش‌ها

توصیه: MCP Server + AGENTS.md را در کنار هم فعال کنید، و در Claude Code علاوه بر این‌ها پلاگین را هم نصب کنید.

۵. مرجع سریع — تک‌خطی برای هر ابزار

دستور run یکی است: npx -y @parto-system-design/mcp-server

صفحات مرتبط

• پلاگین Claude Code — راه‌اندازی کامل پلاگین (skills، agents، hooks)
• وایب‌کدینگ با پرتو — پرامپت‌های آماده پس از اتصال
• نصب و راه‌اندازی — نصب پکیج npm پایه