سرورهای MCP

افزودن tool، resource و prompt به AiraCode از طریق سرورهای Model Context Protocol.

MCP به AiraCode اجازه می‌ده به tool‌های بیرونی وصل بشه — مثل دیتابیس، API خصوصی، مستندات داخلی و فایل‌سیستم محدود.

افزودن یک سرور

# stdio server
aira mcp add my-db -- npx -y @modelcontextprotocol/server-postgres "postgresql://localhost/dev"

# HTTP server
aira mcp add my-api --transport http https://my-api.example.com/mcp \
  --header "Authorization=Bearer $TOKEN"

aira mcp list
aira mcp remove my-db

جایی که ذخیره می‌شه

  • ~/.aira/.mcp.json — سرورهای global user-level.
  • .mcp.json در ریشهٔ پروژه — مخصوص همون پروژه.
  • کانفیگ پروژه می‌تونه سرور همنام در سطح global رو override کنه.

tool‌های یک سرور

tool‌های MCP با پیشوند mcp__<server-slug>__<tool-name>در فهرست tool‌های در دسترس ظاهر می‌شن.

# With the my-db server above:
# mcp__my-db__query
# mcp__my-db__schema
# mcp__my-db__execute

# permissions.allow = ["mcp__my-db__schema", "mcp__my-db__query"]

احراز هویت برای MCP

برای سرورهایی که خودشون OAuth دارن، AiraCode از flow استاندارد MCP OAuth پشتیبانی می‌کنه و توکن‌ها رو در ~/.aira/.mcp-tokens.json ذخیره می‌کنه.

اجرای AiraCode به‌عنوان سرور MCP

aira mcp serve

{
  "mcpServers": {
    "airacode": {
      "command": "aira",
      "args": ["mcp", "serve"],
      "env": { "AIRA_API_KEY": "..." }
    }
  }
}