English Français العربية

Mailly

السجل الرسمي الأمن

A real inbox for agents: read mail, draft replies you approve, wait for verification codes.

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

التثبيت

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

Remote (streamable-http)
Claude Code 
claude mcp add --transport http mailly 'https://mcp.mailly.site/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "mailly": {
            "type": "http",
            "url": "https://mcp.mailly.site/mcp"
        }
    }
}

التوثيق

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

المحتويات
  1. mailly-mcp
  2. Use the hosted server
  3. Run it yourself
  4. Develop
  5. License

mailly-mcp

The MCP server behind Mailly's connector, plus the Mailly plugin for Claude and Codex.

  • src/: the MCP server, a Cloudflare Worker. It offers typed tools for Mailly mail, drafts, sending, domains, contacts, templates, campaigns, workflows and webhooks. Every tool calls the Mailly REST API with the caller's Mailly API key, so authentication, billing and workspace isolation all stay in the API.
  • ui/: the MCP Apps UI (email and draft cards), bundled into ui:// resources. It is off unless MCP_APPS=1.
  • plugins/mailly: the plugin for Claude (claude.ai, Cowork and Claude Code) and Codex. It points at the hosted server and adds a skill for working with email safely.

Use the hosted server

Add https://mcp.mailly.site/mcp as a remote MCP server and sign in with your Mailly account (OAuth). In Claude Code you can install the plugin instead:

/plugin install mailly --marketplace superagents-lab/mailly-mcp

This server is an OAuth protected resource. Mailly's API (https://api.mailly.site/api/auth) is the authorization server: clients find it through /.well-known/oauth-protected-resource, sign the user in there, and send the access token here. The server passes the token, or an API key, unchanged to Mailly's REST API, which checks it and the scopes it carries. The tool list is narrowed to the same scopes (GET /me).

Run it yourself

npm install
npm run dev          # wrangler dev on http://localhost:8787/mcp

Call /mcp with Authorization: Bearer <your Mailly API key> (from https://mailly.site/app/developers). Without the MAILLY_API service binding it calls MAILLY_API_URL (default https://api.mailly.site) over the internet. To host your own copy, change the mcp.mailly.site route in wrangler.jsonc. OAuth sign-in only works at https://mcp.mailly.site/mcp, because Mailly issues tokens for that resource; elsewhere use an API key.

Develop

npm run typecheck
npm test             # builds dist/worker.js and runs it in Miniflare against a stub API

The Mailly server repository runs its OAuth and end-to-end tests against dist/worker.js from a sibling checkout of this repository.

server.json is the listing in the MCP Registry as site.mailly/mcp. The site.mailly namespace is proven by a DNS TXT record on mailly.site, so publish with mcp-publisher login dns --domain mailly.site --private-key <key> and mcp-publisher publish from a machine that holds the key. Bump version for each release.

License

MIT

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

ما هو Mailly؟

A real inbox for agents: read mail, draft replies you approve, wait for verification codes.

كيف أثبّت Mailly؟

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

هل يحتاج Mailly إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Mailly مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Mailly؟

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

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