Automata

网站 · 注册 · 文档 · 联系

Automata MCP 可安全地让 Claude（或 Codex 或任何 AI Agent）访问你的 WhatsApp、Telegram、电子邮件和 PostgreSQL。 连接一个 账号或数据库，然后创建一个仅限于你选择的聊天或 表的连接器令牌，并将其 URL 粘贴到 Claude 中，作为自定义连接器。Claude 随后便可读取、搜索和总结对话，查询数据；并且只有在你允许时， 才能发送消息和写入行。

使用托管版本 mcp.getautomata.app ——免费连接一个账户，并可免费试用 Pro 版 7 天——也可以通过 Railway 一键部署，或使用 Docker 运行自己的实例。

截图

Claude 在一个回答中，从 WhatsApp 群组提取会议计划，并从你的数据库中获取数字。

用日常语言询问销售情况；未共享的表（如工资表）仍无法访问。

每个连接——WhatsApp、Telegram 或 PostgreSQL——都有自己的 Claude 连接器。

作为自定义连接器添加到 Claude，并可为每个工具设置权限。

## 功能

• 四种连接方式。 通过二维码配对的 WhatsApp 账号、通过二维码关联的 Telegram 账号、通过 IMAP 接入的邮箱，或使用连接字符串连接的 PostgreSQL 数据库。
• 21 个 MCP 工具。 检查状态、列出聊天、读取和搜索消息、发送文本；列出、搜索和读取邮件并获取附件；列出和描述表、运行查询，并在获得授权时执行写入语句。请参阅工具列表。
• 不止是新消息，还包括你的历史记录。 配对号码时会导入 WhatsApp 历史记录；Telegram 聊天会同步并补全历史消息。
• 作用域受限的连接器令牌。 每个令牌只能访问一个连接，还可以进一步限制为特定聊天、文件夹、表和工具。令牌仅显示一次，只以哈希形式存储，并可设置过期时间、轮换或撤销。
• 数据库默认只读。 查询在只读事务中逐条运行，并通过检查查询计划来确认是否符合令牌的表允许列表。必须明确授权写入工具才能写入；如果写入会影响超过允许数量的行，则会回滚。
• 让 Claude 值得信赖的回答。 每一页都会说明是否还有更多内容；系统会过滤并统计表情回应和 WhatsApp 控制记录、合并同一消息的重复副本，并将 @ 提及解析为姓名。
• 专为团队打造。 支持设有管理员和成员的组织、电子邮件邀请，以及将连接分配给需要使用它们的人员。
• 双重身份验证。 支持身份验证器应用、通行密钥和安全密钥，并提供恢复代码。请参阅双重身份验证。
• 断连提醒。 WhatsApp 或 Telegram 连接断开时，所有有权访问该连接的人都会收到电子邮件；连接恢复时也会再次收到通知。
• 使用你自己的后端。 将连接指向你自己的 Evolution API 服务或 Telegram 桥接服务，而非部署自带的服务。

快速开始

托管服务

在 mcp.getautomata.app 注册，然后跳转到连接 Claude。免费版包含一个连接、一个连接器令牌和一个用户；Pro 版在 7 天试用期后每月收费 $19，包含无限数量的连接和令牌，以及 5 个用户（之后每位用户收费 $10）。

Railway（一键部署）

1. 部署模板。
2. 打开 Web 服务的域名并注册——第一个账号将成为管理员。
3. 可选：为桥接服务设置 TELEGRAM_API_ID / TELEGRAM_API_HASH 以启用 Telegram，并为 Web 服务设置 NUXT_SMTP_* 变量以启用电子邮件。

部署到 Railway中说明了每项服务和变量。

Docker（单容器）

docker run -d --name automata --restart unless-stopped --stop-timeout 30 \
  -p 3000:3000 -v automata_data:/data \
  -e NUXT_PUBLIC_APP_URL=https://automata.example.com \
  ghcr.io/ju-li/automata-mcp-aio:1

在一个容器中运行 Postgres、Redis、Evolution API、Web 应用和 Telegram 桥接服务；首次启动时会将密钥生成到卷中。请备份该卷——参阅单容器。

Docker Compose

git clone https://github.com/ju-li/automata-mcp.git && cd automata-mcp
cp .env.selfhost.example .env
for k in POSTGRES_PASSWORD WEBHOOK_SECRET EVOLUTION_API_KEY TELEGRAM_BRIDGE_ADMIN_KEY TELEGRAM_SESSION_ENCRYPTION_KEY; do
  echo "$k=$(openssl rand -hex 32)"; done >> .env

docker compose up -d                                         # database connections
docker compose --profile whatsapp up -d                      # + WhatsApp
docker compose --profile whatsapp --profile telegram up -d   # + Telegram

打开 http://localhost:3000 并注册。在 Claude 连接前，将 .env 中的 NUXT_PUBLIC_APP_URL 设置为公开的 https:// 地址——连接器 URL 会根据该地址生成。请参阅自托管。

警告

配对会绑定一个真实的 WhatsApp 号码；反复配对和取消配对的号码可能会被封禁——请使用备用 SIM 卡。切勿运行 docker compose down -v 或删除单容器的卷：这两种操作都会删除所有已配对的会话。

连接 Claude

1. 创建连接并进行配对、关联，或粘贴连接字符串。
2. 在连接的仪表板中创建一个连接器令牌，并选择该令牌可访问的内容。
3. 在 Claude 中，打开设置 → 连接器 → 添加自定义连接器并粘贴连接器 URL。对于 Claude Code：claude mcp add --transport http <name> <url>。

文档

• 产品文档：https://www.getautomata.app/docs
• 运行和开发此代码库：docs/ — 自托管、Railway、 WhatsApp、Telegram、 电子邮件、PostgreSQL、告警、 双因素认证、 开发

许可证

MIT