سرور MCP

دستیارِ هوش مصنوعی‌تان را به Vi وصل کنید

Vi یک سرور MCP داخلی دارد. یک آدرس را در Claude، Claude Code، Cursor، VS Code یا Codex اضافه کنید، یک بار در مرورگر تأیید کنید، و دستیار به‌جای شما تسک‌های Vi را می‌خواند، می‌سازد و رویشان کار می‌کند.

سرور MCPِ Vi چیست؟

سرور MCPِ Vi یک نقطه‌ی اتصالِ راه‌دورِ Model Context Protocol در آدرسِ https://useviapp.com/mcp است که به دستیارِ هوش مصنوعی اجازه می‌دهد با حسابِ خودِ شما در Vi کار کند. از Streamable HTTP و ورود با OAuth استفاده می‌کند؛ پس چیزی برای نصب و توکنی برای کپی‌کردن ندارد. در همه‌ی پلن‌های Vi، از جمله رایگان، هست و دستیار صندلیِ جداگانه نمی‌گیرد؛ هزینه‌ی خودِ دستیار با همان سرویسِ هوش مصنوعی‌ای است که الان استفاده می‌کنید.

آدرسِ کانکتور
https://useviapp.com/mcp

چطور Vi را به دستیارِ هوش مصنوعی‌ام اضافه کنم؟

آدرسِ کانکتور را در دستیار اضافه کنید و بعد یک بار در مرورگر با حسابِ Vi اتصال را تأیید کنید. ابزارتان را انتخاب کنید:

Claude Code

این دستور را یک بار در ترمینال اجرا کنید. بعد Claude Code را باز کنید، ‎/mcp را بزنید، vi را انتخاب کنید و Authenticate را بزنید. با ‎--scope user، Vi در همه‌ی پروژه‌های شما در دسترس است.

claude mcp add --scope user --transport http vi https://useviapp.com/mcp

Claude (claude.ai و Claude Desktop)

به Settings › Connectors بروید، یک کانکتورِ سفارشی با نامِ Vi و آدرسِ کانکتورِ بالا اضافه کنید، Connect را بزنید و در پنجره‌ای که باز می‌شود تأیید کنید. امکانِ کانکتورِ سفارشی به پلنِ Claude شما بستگی دارد؛ در پلن‌های تیمی ممکن است اول مالک باید آن را اضافه کند.

Cursor

Vi را به ‎~/.cursor/mcp.json (یا ‎.cursor/mcp.json در یک پروژه) اضافه کنید. بعد Cursor Settings › MCP را باز کنید و وقتی Cursor خواست، برای vi وارد شوید.

{
  "mcpServers": {
    "vi": { "url": "https://useviapp.com/mcp" }
  }
}

VS Code (GitHub Copilot)

Vi را به ‎.vscode/mcp.json در workspace اضافه کنید، یا از Command Palette فرمانِ «MCP: Add Server» را اجرا و HTTP را انتخاب کنید. سرور را Start کنید و وقتی VS Code خواست، ورود را تأیید کنید.

{
  "servers": {
    "vi": { "type": "http", "url": "https://useviapp.com/mcp" }
  }
}

Codex CLI

Vi را به ‎~/.codex/config.toml اضافه کنید و بعد با دستورِ دوم یک بار وارد شوید.

[mcp_servers.vi]
url = "https://useviapp.com/mcp"
codex mcp login vi

کلاینت‌های دیگرِ MCP

هر کلاینتی که سرورِ MCPِ راه‌دور را با Streamable HTTP و OAuth پشتیبانی کند، با همین آدرسِ کانکتور وصل می‌شود. کلاینتی که فقط سرورهای محلی (stdio) را اجرا می‌کند مستقیم وصل نمی‌شود.

موقعِ اتصال چه اتفاقی می‌افتد؟

  1. 1

    دستیار یک پنجره‌ی مرورگر با صفحه‌ی ورودِ Vi باز می‌کند. با حسابِ معمولیِ Vi وارد شوید؛ رمزِ شما هرگز به دستیار داده نمی‌شود.

  2. 2

    Vi نشان می‌دهد کدام برنامه و برای کدام workspace درخواست داده است. فقط اگر خودتان اتصال را شروع کرده‌اید تأیید کنید.

  3. 3

    دستیار وصل شد. آن را در Vi زیرِ تنظیمات › اتصال هوش مصنوعی می‌بینید و هر وقت خواستید همان‌جا قطعش می‌کنید.

دستیار در Vi چه کارهایی می‌تواند بکند؟

خواندنِ پروژه‌ها، تیم‌ها، اعضا و تسک‌ها، شاملِ توضیحات، کامنت‌ها، زیرتسک‌ها و مرحله‌ی فعلیِ گردش‌کار.

جستجو پیش از ساختن، و بعد ساختنِ تسک و زیرتسک. تسک‌های احتمالاً تکراری اول نشان داده می‌شوند و می‌گوید تسک به کدام پروژه، مرحله و فرد رفت.

افزودنِ کامنتِ داخلی به تسک. کامنتی که این‌طور اضافه شود هرگز برای مشتری ایمیل نمی‌شود.

کار روی تسک با شماره‌اش: Vi آن را در IDE شما شروع می‌کند، درست مثلِ زدنِ Start، و دستیار در پایان با یک کامنت گزارش می‌دهد.

متوقف‌کردنِ تسکِ در حالِ انجام، بعد از موافقتِ شما در IDE، تا بتواند سراغِ تسکِ دیگر یا یک زیرتسک برود.

درخواستِ بستنِ تسک از شما. IDE فایل‌های تغییرکرده را نشان می‌دهد، شما تأیید می‌کنید و همان Commit & Closeِ دکمه‌ی Done اجرا می‌شود.

چه کارهایی را هرگز نمی‌تواند بکند؟

دستیار همان دسترسیِ شما را دارد و نه بیشتر. نمی‌تواند چیزی را حذف کند، تسک را خودش بینِ مرحله‌های گردش‌کار جابه‌جا کند، تنظیمات و اعضا و پلن را تغییر دهد، یا بدونِ تأییدِ شما در IDE کامیت و push کند. سطحِ دسترسیِ فقط‌خواندنی هم هست، و مالکِ workspace می‌تواند اتصالِ AI را برای کلِ workspace خاموش کند.

می‌توانم به دستیارم بگویم «تسکِ ۱۴۲ را انجام بده»؟

بله — دستیار تسکِ ۱۴۲ را در IDE شما شروع می‌کند، توضیحات و کامنت‌ها و زیرتسک‌هایش را می‌خواند، تغییر را انجام می‌دهد و یک کامنتِ خلاصه می‌گذارد. وقتی بستنِ تسک را بخواهید، Vi درخواست را به پنجره‌ی IDEِ همان پروژه (VS Code، Visual Studio، RAD Studio یا Lazarus) می‌فرستد تا فایل‌ها را ببینید و تأیید کنید. تسکی که بازبین برگردانده باشد، بر اساسِ یادداشتِ بازبین انجام می‌شود. Claude Code دو دستورِ آماده هم می‌گیرد: ‎/mcp__vi__do_task و ‎/mcp__vi__plan_subtasks.

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

دنبالِ فایلِ ‎.vi در مخزنِ شما می‌گردد، همان فایلی که افزونه‌های IDEِ Vi با آن یک پوشه را به پروژه وصل می‌کنند، و از شما تأیید می‌گیرد. اگر نباشد، فهرستِ پروژه‌هایتان را نشان می‌دهد و می‌پرسد کدام را استفاده کند.

{"tenant":"acme","projectId":12,"projectName":"Website"}

پرسش‌های پرتکرار

سرور MCPِ Vi رایگان است؟

بله — سرور MCP در همه‌ی پلن‌های Vi، از جمله رایگان، هست و دستیار صندلی نمی‌گیرد. فقط هزینه‌ی همان دستیارِ هوش مصنوعی‌ای را می‌دهید که الان استفاده می‌کنید.

کلیدِ API یا توکن لازم دارم؟

نه — یک بار در مرورگر با حسابِ Vi اتصال را تأیید می‌کنید (OAuth). رمزِ شما هرگز به دستیار داده نمی‌شود و اتصال را در تنظیمات › اتصال هوش مصنوعی می‌توانید حذف کنید.

کدام دستیارهای هوش مصنوعی با Vi کار می‌کنند؟

هر کلاینتِ MCP که سرورِ راه‌دورِ Streamable HTTP را با ورودِ OAuth پشتیبانی کند وصل می‌شود، از جمله Claude، Claude Code، Cursor، VS Code با GitHub Copilot و Codex.

دستیار می‌تواند تسک‌هایم را ببندد یا حذف کند؟

نه — نمی‌تواند چیزی را حذف کند یا تسک را خودش جابه‌جا کند. می‌تواند از شما بخواهد تسکی را ببندید، و بستن فقط بعد از دیدنِ فایل‌ها و تأییدِ شما در IDE انجام می‌شود.

Vi از راهِ MCP کدِ منبعِ من را می‌بیند؟

نه — دستیار کد را روی سیستمِ خودِ شما ویرایش می‌کند و Git به‌صورتِ محلی از راهِ افزونه‌ی IDEِ Vi اجرا می‌شود. Vi فقط داده‌ی تسک و متادیتای کامیت را می‌گیرد، هرگز کدِ منبع را.

مالکِ workspace می‌تواند اتصالِ AI را خاموش کند؟

بله — مالک می‌تواند در تنظیمات › اتصال هوش مصنوعی آن را برای کلِ workspace خاموش کند و همه‌ی دستیارهای متصل فوراً قطع می‌شوند.

مرتبط: مدیریت پروژه در IDE · Commit & Close · امنیت · قیمت‌ها

روی تسک‌های خودتان امتحانش کنید

یک workspaceِ رایگان بسازید، آدرسِ کانکتور را به دستیار بدهید و از او بخواهید پروژه‌هایتان را فهرست کند.

شروعِ رایگان