اتصال ایجنت‌های هوش مصنوعی به گره (MCP)

ایجنت برنامه‌نویسی شما، حالا اپراتور زیرساخت هم هست.

Model Context ProtocolStreamable HTTP

با سرور MCP گره، ایجنت‌های برنامه‌نویسی مثل Claude Code، Cursor، Codex و Copilot در VS Code می‌توانند مستقیم اپ‌ها، پایگاه‌های داده، سرورها و دامنه‌های شما را ببینند و مدیریت کنند: دیپلوی، خواندن لاگ و خطای بیلد، تنظیم متغیرها، ری‌استارت و ویرایش DNS؛ همه با زبان طبیعی.

نشانی

https://gereh.virgule.studio/api/mcp

پروتکل: MCP با انتقال Streamable HTTP. احراز هویت با همان توکن‌های API عمومی: هدر Authorization: Bearer grh_….

ساخت توکن

در پنل › SSH و API یک توکن بسازید:

فقط خواندن: ایجنت فقط وضعیت، لاگ و فهرست‌ها را می‌بیند. برای شروع امن‌تر است.
خواندن و نوشتن: ایجنت می‌تواند دیپلوی، ری‌استارت و تغییر تنظیمات هم انجام دهد.

برای هر ابزار یا هر سیستم یک توکن جدا بسازید تا در صورت نیاز فقط همان را باطل کنید.

اتصال

خودکار (CLI)

CLI گره ابزارهای نصب‌شده (Claude Code، Cursor، VS Code و Codex) را پیدا می‌کند و اتصال را برایشان می‌سازد.

npx @gereh/cli login
npx @gereh/cli setup agent

Claude Code

یک بار اجرا کنید؛ از آن به بعد کافی است به Claude بگویید «اپ shop را دیپلوی کن و لاگ را بررسی کن».

claude mcp add --transport http --scope user gereh https://gereh.virgule.studio/api/mcp \
  --header "Authorization: Bearer grh_YOUR_TOKEN"

Cursor

پس از ذخیره، در Settings › MCP سرور gereh را فعال کنید. فایل: ~/.cursor/mcp.json

{
  "mcpServers": {
    "gereh": {
      "url": "https://gereh.virgule.studio/api/mcp",
      "headers": {
        "Authorization": "Bearer grh_YOUR_TOKEN"
      }
    }
  }
}

VS Code

توکن در فایل ذخیره نمی‌شود؛ VS Code بار اول آن را می‌پرسد و در حافظه امن خودش نگه می‌دارد. با Copilot در حالت Agent کار می‌کند. فایل: .vscode/mcp.json

{
  "inputs": [
    {
      "type": "promptString",
      "id": "gereh-token",
      "description": "Gereh API token (grh_…)",
      "password": true
    }
  ],
  "servers": {
    "gereh": {
      "type": "http",
      "url": "https://gereh.virgule.studio/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:gereh-token}"
      }
    }
  }
}

Codex

توکن را در متغیر GEREH_TOKEN قرار دهید (export GEREH_TOKEN=grh_…). فایل: ~/.codex/config.toml

[mcp_servers.gereh]
url = "https://gereh.virgule.studio/api/mcp"
bearer_token_env_var = "GEREH_TOKEN"

ابزارها

ابزار	کار	نیاز به دسترسی نوشتن
`get_account`	The signed-in Gereh account: name, email and wallet balance in Toman.	—
`list_apps`	All Gereh Apps (PaaS) of the account with status, URL, size and latest deployment.	—
`get_app`	One app: status, URL, domains, plan, instances, hourly price and latest deployment.	—
`deploy_app`	Starts a new deployment: Git apps rebuild the configured branch, image apps pull the image again	بله
`promote_deployment`	Releases a successful preview deployment's image to production without rebuilding (the release command runs first).	بله
`get_deployment`	Status (queued, building, deploying, live, failed…) and the full build log of a deployment.	—
`app_logs`	The last 300 runtime log lines of the app's running instances.	—
`set_app_env`	Sets (or with a null value removes) environment variables and restarts the app with them; no rebuild	بله
`app_action`	Power action on an app.	بله
`run_job`	Runs a one-off command (e.g	بله
`get_job`	Status (running, succeeded, failed) and output of a one-off job started with run_job.	—
`list_databases`	Managed databases (PostgreSQL, MySQL, MariaDB, MongoDB, Redis) with engine, status and size.	—
`list_servers`	Cloud servers (VPS) with status, IPs, size and location.	—
`get_server`	One cloud server.	—
`server_action`	Power action on a cloud server.	بله
`list_domains`	Registered domains with status, name servers and expiry.	—
`list_dns_records`	DNS records of a domain.	—
`add_dns_record`	Adds a DNS record (A, AAAA, CNAME, MX, TXT, NS, SRV, CAA) to a domain.	بله
`delete_dns_record`	Removes a DNS record.	بله
`list_invoices`	Invoices with status and total in Toman.	—

نمونه درخواست‌ها

«وضعیت همه اپ‌هایم را بگو و اگر استقراری ناموفق بوده، علتش را از لاگ بیلد پیدا کن.»
«اپ shop را دوباره دیپلوی کن و تا فعال شدن صبر کن.»
«متغیر SENTRY_DSN را به‌صورت secret روی اپ api تنظیم کن.»
«برای دامنه example.ir یک رکورد CNAME با نام www به shop.gereh.dev بساز.»

امنیت

هر کاری که ایجنت انجام می‌دهد با همان بررسی‌های مالکیت و اعتبارسنجی پنل انجام و در گزارش فعالیت حساب ثبت می‌شود.
اکثر ایجنت‌ها پیش از اجرای ابزارهای نوشتنی از شما تأیید می‌گیرند؛ ابزارهای خواندنی با برچسب readOnly اعلام شده‌اند.
توکن را در مخزن گیت قرار ندهید. برای VS Code از فرم بالا استفاده کنید که توکن را در فایل نمی‌نویسد.