English Français العربية

smbCloud Mail & Auth

السجل الرسمي الإنتاجية

Email infrastructure and authentication for developers: domains, inbox routes, auth apps, deploys.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http smbcloud-mail-auth 'https://api.smbcloud.xyz/v1/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "smbcloud-mail-auth": {
            "type": "http",
            "url": "https://api.smbcloud.xyz/v1/mcp"
        }
    }
}
NPM package @smbcloud/cli
Claude Code 
claude mcp add smbcloud-mail-auth -e 'SMB_MAIL_API_KEY=<your smb_mail_api_key>' -- npx -y @smbcloud/cli@0.7.5 --mcp
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "smbcloud-mail-auth": {
            "command": "npx",
            "args": [
                "-y",
                "@smbcloud/cli@0.7.5",
                "--mcp"
            ],
            "env": {
                "SMB_MAIL_API_KEY": "<your smb_mail_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • SMB_MAIL_API_KEY سري Mail app API key (smb_mail_...) used by the mail_send tool. Optional: every other tool uses the session from `smb login`.
NUGET package SmbCloud.Cli
Claude Code 
claude mcp add smbcloud-mail-auth -e 'SMB_MAIL_API_KEY=<your smb_mail_api_key>' -- dnx SmbCloud.Cli@0.7.5 --yes --mcp
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "smbcloud-mail-auth": {
            "command": "dnx",
            "args": [
                "SmbCloud.Cli@0.7.5",
                "--yes",
                "--mcp"
            ],
            "env": {
                "SMB_MAIL_API_KEY": "<your smb_mail_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • SMB_MAIL_API_KEY سري Mail app API key (smb_mail_...) used by the mail_send tool. Optional: every other tool uses the session from `smb login`.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. smbCloud CLI
  2. About
  3. Install
  4. Quick Start
  5. MCP server
  6. CI / non-interactive mode
  7. Documentation
  8. Contributing
  9. License
  10. Copyright

smbCloud CLI

smbCloud Mail, Auth, Deploy, and GresIQ from your terminal or your AI agent.

Website · Documentation · Contributing · Releases

About

smb is the command-line interface for smbCloud. It is also an MCP server, so Claude, Cursor, and other AI agents can run the same operations you do.

Send transactional email and set up domains and inbox routing on smbCloud Mail, manage authentication apps on smbCloud Auth, and deploy Rust, Node.js, Ruby, or Swift apps. One binary, no runtime to install.

Install

If you want the quickest setup, use a pre-built native binary.

Homebrew (macOS & Linux)
brew tap smbcloudXYZ/tap && brew trust --tap smbcloudXYZ/tap
brew install cli
npm
npm install -g @smbcloud/cli
.NET tool
dotnet tool install --global SmbCloud.Cli
pip
pip install smbcloud-cli
Shell (macOS / Linux)
curl -fsSL https://raw.githubusercontent.com/smbcloudXYZ/smbcloud-cli/main/install-unix.sh | sh
PowerShell (Windows)
irm https://raw.githubusercontent.com/smbcloudXYZ/smbcloud-cli/main/install-windows.sh | iex

Or grab a pre-built binary from the Releases page.

Quick Start

smb login
smb init
smb deploy

That gets you from login to first deploy.

MCP server

smb --mcp speaks the Model Context Protocol over stdio, exposing 31 tools across smbCloud Mail, Auth, projects, and deployments. It is listed in the official MCP Registry as io.github.smbcloudXYZ/smbcloud-cli.

Claude Code:

claude mcp add smbcloud -- smb --mcp

Claude Desktop, Cursor, and anything else that takes a JSON config:

{
  "mcpServers": {
    "smbcloud": {
      "command": "npx",
      "args": ["@smbcloud/cli", "--mcp"]
    }
  }
}

Auth comes from smb login, so a terminal session and an agent session share the same token and the same selected project. See docs/mcp.md for the full tool reference.

For mobile and TV app testing, run the focused XCRS Mobile & TV Automation profile:

claude mcp add xcrs -- smb --mcp --scope automation

It exposes target-aware Xcode, ControlKit, CoreDevice, and adb tools without mixing them into the cloud tool set. The same profile is also available from the standalone xcrs --mcp crate.

CI / non-interactive mode

Pass --ci (or set SMB_CI=1, or run under any provider that sets CI) to disable interactive prompts. Confirmations take their default; anything that truly needs input fails fast with a clear message instead of hanging on a missing TTY.

smb --ci deploy

For example, the AircraftsHub monorepo deploys its Next.js web app with a single non-interactive command — its .smb/config.toml pins the project, source, and runtime, so smb --ci deploy needs no prompts. See docs/ci.md for token setup and the full behavior reference.

Documentation

See the docs/ directory for guides on authentication, project configuration, and deployment workflows.

Contributing

Read CONTRIBUTING.md to get started. Contributions are welcome.

For the broader product, see smbCloud and the deployment docs.

License

Apache-2.0

© 2026 Splitfire AB (smbCloud).

الأسئلة الشائعة

ما هو smbCloud Mail & Auth؟

Email infrastructure and authentication for developers: domains, inbox routes, auth apps, deploys.

كيف أثبّت smbCloud Mail & Auth؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http smbcloud-mail-auth 'https://api.smbcloud.xyz/v1/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج smbCloud Mail & Auth إلى مفتاح API؟

نعم. يتطلب SMB_MAIL_API_KEY، وتضبطها في إعداداته.

هل smbCloud Mail & Auth مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون smbCloud Mail & Auth؟

ينشره smbcloudXYZ. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.