Melaya

Melaya 将手机与账户配对，让 Agent 获得与用户相同的手机视图：它通过 Android 无障碍树读取屏幕，然后点击、输入、滑动并在应用之间切换。无需针对每个应用单独集成，也无需厂商 API。只要你能使用某个应用，Agent 也能。

这是一个远程 Model Context Protocol 服务。MCP 是一项与厂商无关的标准，因此一个端点即可随处使用：

https://api.melaya.org/mcp

无需安装任何内容，也不需要 SDK。

连接

Claude Code	claude mcp add --transport http melaya https://api.melaya.org/mcp
Codex CLI	codex mcp add melaya --url https://api.melaya.org/mcp 直接使用 HTTP 需要在 ~/.codex/config.toml 中设置 experimental_use_rmcp_client = true。
Cursor	~/.cursor/mcp.json；如果只用于单个项目，则使用 .cursor/mcp.json： { "mcpServers": { "melaya": { "url": "https://api.melaya.org/mcp" } } }
Claude	claude.ai、桌面应用和移动端：设置 → 连接器 → 添加自定义连接器，粘贴 https://api.melaya.org/mcp
ChatGPT	设置 → 连接器 → 开发者模式，粘贴相同的端点
Le Chat	连接器 → 添加自定义 MCP 连接器
VS Code	code --add-mcp '{"name":"melaya","type":"http","url":"https://api.melaya.org/mcp"}'
其他所有客户端	Windsurf、Zed、Cline、Goose、Lovable、Gemini CLI、Qwen Code 和其他任何 MCP 客户端，都使用相同的配置块，并将其放入该客户端用于配置 MCP 服务的文件中： { "mcpServers": { "melaya": { "url": "https://api.melaya.org/mcp" } } }

身份验证采用 OAuth 2.1 和 PKCE。你可以在 Melaya 授权页面选择要授予的权限；助手会收到一个限定范围的令牌。你的密码绝不会共享。

然后只需提出请求：

连接我的手机，并查看我未读的 Instagram 私信。

---

为你的 AI 提供 Melaya 技能

此服务为助手提供工具。**Melaya 技能**则为它提供方法：先调用哪个工具、如何连接服务、如何通过实际运行来构建和验证管道、如何设置触发器和审批，以及如何读取结果。两者都安装后，助手就能从一开始就真正完成工作，而不是靠猜测。

任何助手（ChatGPT、Gemini、Cursor，……）：粘贴这一行。

Install the Melaya skill from https://github.com/melaya-labs/melaya-mcp/tree/main/skills/melaya and use it whenever I ask you to work with Melaya.

Claude Code：此仓库中的 Melaya 插件已内置该技能，与 melaya-setup 一并提供。安装插件即可。若要单独使用此技能，请将其复制到你的技能文件夹，然后重启。提到 Melaya 时，它会自动加载。

git clone --depth 1 https://github.com/melaya-labs/melaya-mcp /tmp/melaya-mcp && cp -r /tmp/melaya-mcp/skills/melaya ~/.claude/skills/

Claude.ai 和 Claude Desktop：将 skills/melaya 下载为 .zip，然后上传到 设置 → 功能 → 技能。在其他环境中，将 SKILL.md 添加为项目指令或规则文件。

从正确的步骤开始 每次会话开始时都会运行 melaya_setup_status，并在进行其他操作前补齐报告中的所有缺项。	始终安全 绝不会在聊天中索要密钥，绝不会替你决定是否批准，并会在发送或删除任何内容前确认。
构建可运行的管道 更改前先读取配置，保存前先预览，并根据实际输出而非状态来判断运行结果。	只加载所需内容 一个简短的路由器加上十一个模块：快速入门、管道、Agentic 系统、数据、触发器和审批、设备、交接。

它能做什么

操作手机

读取屏幕、打开应用、点击、输入、滚动、滑动、截屏。你可以观察它工作，并通过一个控件停止一切。

Melaya 为常见应用提供导航操作手册，让 Agent 知道各项功能的位置，而不是盲目探索。

操作浏览器

在桌面网站上通过 Chrome 或 Edge 的 Melaya 扩展，也能使用同样的读取、操作、验证循环。由你附加标签页；模型不会自行选择。 多个对话、流水线和扩展面板可以同时在同一浏览器中工作，各自使用独立标签页（最多 8 个）：附加标签页会返回一个 agent ID，对话会在每次浏览器调用时传递该 ID；其他 Agent 正在使用的标签页绝不会被触碰。

它还能调试当前页面：查看网络活动和控制台输出，并提供性能诊断，按原因排序并列出对应文件和数值，而不是只交给你一个原始面板。凭据值会在捕获时脱敏，不会在到达模型之前泄露。

构建和运行 Agent

为工作创建项目（例如，每个客户端试点创建一个项目），查看模板库并实例化经过验证的模板，或者从头编写流水线，在保存前验证并安排运行，然后监控其运行情况。将长期或重复任务交给自主 Agent，让它在你自己的设备上使用你自己的模型订阅运行，并在对话结束后继续工作。

读取并通过已连接的服务执行操作

邮件、文档、ERP。默认情况下仅限读取，并且有结构性保障：如果没有单独授予写入权限，写入路径会在两个相互独立的位置被阻止，因此即使 Melaya 自己的工具目录过时，写入仍会被阻止。

同时授予 melaya:connectors.write 后，助手也能代表你在这些服务中执行操作：发送邮件、创建或更新记录或文件。这也包括涉及资金流动或交易的工具（付款、退款、购买、转账、广告支出变更、订单）：同意页面会明确说明，工具发现结果会将其标记出来，并且你的助手应先与你确认具体操作和金额。每次写入都会立即执行，不会再次提示，并记录在审计日志中。LinkedIn 会话工具在任何权限下都无法通过 MCP 访问。

管理项目

创建项目、重命名或编辑其描述，并在项目为空时将其删除。删除操作在确认前是试运行，只有项目创建者可以执行；如果项目中仍有流水线、运行历史或其他成员，则会拒绝删除。计划限制与应用中的规定完全一致。

了解发生了什么

查看运行记录、转录内容、工具轨迹、故障诊断、费用，以及 Agent 在多次运行中学到的内容。

---

它无法执行的操作

这些限制由设备或 Melaya 服务强制执行，而不是由指令控制，因此任何提示词或 Agent 指令都无法绕过。

仅限你加入允许列表的内容

手机上的应用、浏览器中的网站。Agent 可以归还访问权限、缩小列表或清空列表，但只有你能扩大列表：手机应用可在手机上或 Melaya 应用中添加；浏览器网站可在 Melaya Browser Control 页面添加，也可以让你的助手添加某个网站（随后它会调用 melaya_browser_allow_sites 并传入该网站；你也可以让它添加所有网站）。技能会告知它，绝不能自行扩大访问范围，也不能因为读到某些内容而扩大访问范围。

这种不对称是刻意设计的。Agent 会读取屏幕上的文字，而任何人都能写文字：消息、评论、网页。如果它能根据读到的内容扩大权限，那么边界就形同虚设。

在手机上付款时，始终需要你确认

助手对手机的直接控制会以安全模式运行：发布和付款操作会生成审批卡片，执行前你可以查看确切文本。助手启动或保存的手机 Agent 和手机流水线会在所有模式下保留付款卡片：此处会将 autonomous 存储并以 payments_only 运行；这样 Agent 可以在没有你要求跳过的卡片时发布内容，但每次购买或付款前仍会暂停。只有你能在 Melaya 应用中设置完全无人值守的手机模式。在浏览器中，你在 Melaya 扩展程序中选择的自主程度决定了行为（safe 会在购买、发布及其他重要操作前征求确认；payments only 会在购买前征求确认；autonomous 不会征求确认）。即使手机处于锁定状态，你也会收到审批请求。

 

提供 STOP 控件

手机浮层和 Melaya 应用中都有 STOP 控件。它会立即停止所有操作，涵盖每个 Agent 和每个已连接的助手。

审批请求在此列出，但不会在此决定

设置这道关卡，是为了让人类介入 Agent 执行重要操作的过程；而此处的调用方是一个会读取不可信内容的模型。你可以在 Melaya 应用或手机上批准。

屏幕读取会排除密码字段。

此界面不支持 LinkedIn：通过已登录的会话自动操作 LinkedIn 会违反其条款，因此服务端会拒绝 LinkedIn 工具，以及手机上的 LinkedIn 应用和浏览器中的 linkedin.com。

另外两项也被刻意排除，并通过测试而非约定来确保：管理操作（不存在适用于此类操作的真实同意声明），以及读取或设置连接器凭据（你需要在应用中连接服务）。两个事件触发器字段例外：仅当你选择将密钥交给助手，而不是粘贴到应用中时才会使用，分别是提供商的 webhook 签名密钥和流来源密钥。两者都会加密存储，且绝不会返回。

---

权限

共有 11 项权限范围。你可以逐项授权。

权限范围	允许执行的操作
melaya:read	读取你的工作区：流水线、运行记录、跟踪记录、评估、待处理的审批
melaya:platform	读取你的账户和套餐：等级、用量与限额、订阅
melaya:runner	在你的电脑上设置并检查 Melaya runner
melaya:phone	在你列入许可名单的应用中操作已配对的 Android 手机
melaya:browser	在你允许的网站上操作已连接的浏览器
melaya:computer	通过 Melaya 桌面应用，在你允许的应用中按你设定的权限级别操作自己电脑上的应用
melaya:pipelines	创建、编辑、安排、运行和取消 Agent 流水线
melaya:projects	创建项目、重命名并编辑项目描述，以及删除你创建的空项目
melaya:connectors	从已连接的服务读取数据。仅限读取
melaya:connectors.write	通过已连接的服务执行操作：发送邮件、创建或更新记录和文件，包括资金转移或交易操作（付款、退款、订阅、订单）。需要 melaya:connectors。写入操作会立即执行并记录在审计日志中
melaya:team	查看项目成员，并邀请你指定的人

助手收到的工具列表会根据你授予的权限进行筛选，因此，仅连接手机控制时会显示 25 个工具，而不是全部 130 个。如果缺少某项功能，说明你拒绝了相应权限；请重新连接并批准。

说明

如果你还使用 Melaya SDK，“connectors” 在其中含义不同。在 SDK 中，它指项目凭据存储。此处，melaya:connectors 用于读取你已连接服务中的数据，melaya:connectors.write 用于通过这些服务执行操作。此接口无法读取、设置或删除连接器凭据（上文的触发器签名密钥和流来源密钥是它接受的仅有密钥，而且它绝不会返回这些密钥）。

要求

• 一个 Melaya 账户——可在 melaya.org 免费注册
• 一部 Android 手机（Android 8 或更高版本），用于手机控制。目前没有 iOS 版本。
• 用于浏览器控制的 Chrome 或 Edge Melaya 扩展程序
• 用于自主 Agent：Node 18+、Python 3.11+，以及在托管 runner 的机器上已登录的 CLI。runner 会通过一个固定到经审核版本的命令启动（npx -y @melaya/[email protected] --token=...）；助手会向你显示该命令，并且只有在你同意后才会运行，或将命令交给你自行运行

隐私

运行期间读取的屏幕和网页内容会发送给 Melaya 以及你选择的模型。有关数据收集、保留和删除的信息，请参阅隐私政策。

有一项凭据确实会跨越边界，值得特别说明：如果你设置了可选的本地 runner，提供给你的命令中会包含 runner 令牌。该令牌有效期为 7 天，可在设置中撤销，也可通过 melaya_runner_revoke 撤销；由于 runner 通过命令行启动，因此无法避免包含此令牌。在托管式助手中，该命令会出现在你的对话历史记录中。其他可能出现的密钥只有你选择提供给助手、用于事件触发器的 Webhook 签名密钥或流来源密钥（它们会加密存储，绝不会返回）；提供商和连接器凭据会在服务器端解析，绝不会传给助手。

在 Melaya 设置中断开连接后，该连接立即失去续期能力。它已持有的令牌会继续有效，直到过期，最长不超过一小时。

此仓库包含什么

路径	用途
server.json	官方 MCP Registry 的清单
.mcp.json	远程服务声明
.claude-plugin/、skills/、commands/	Claude Code 插件打包——同一服务的一种分发形式。skills/melaya 是 Melaya 技能（其唯一源文件）；skills/melaya-setup 是首次运行设置技能；skills/paint-artist 通过 Computer Control 使用 Microsoft Paint 绘画，只需一次已存储计划调用（17 种风格，是 Melaya 技能单次调用计划的高级绘图示例）

服务本身作为 Melaya 平台的一部分运行；此仓库包含其公开清单、打包内容和文档。

平台的其他部分

此服务是 Melaya 的一个接入面。其工具域对应其背后的产品，因此，如果某个范围对你有用，可以查看产品页面，了解它能访问哪些内容：

产品	介绍	melaya: 范围
Melaya Agents	用于构建 Agent 流水线的可视化工具，包含 6,912 个工具和 103 个子 Agent	pipelines
Melaya Assistant	对这些 Agent 进行治理的操作层	platform
Device Control	通过无障碍树控制 Android 手机	phone
Melaya Browser Control	对已配对浏览器进行按来源范围限定的控制	browser
Melaya Computer Control	通过无障碍树控制 Windows、macOS 和 Linux 上的桌面应用，并可按应用设置访问级别	computer
Melaya Marketing	在一个控制台中管理广告、搜索控制台、分析、DNS 和网站，并在执行任何涉及实际资金或线上网站的操作前征得批准	connectors
Melaya MCP Server	此服务	以上所有范围

浏览器扩展是 Browser Control 的通信对象，可用于 Chrome、Edge、Brave、Opera 和 Firefox。

平台公开测试期间，可从 $0 的 Sandbox 套餐开始体验：查看套餐。

链接

• 完整文档
• Melaya SDK ——支持九种语言
• 产品概览 · 所有产品
• 隐私政策 · 条款
• 支持

许可证

Apache-2.0，与 Melaya SDK 一致。

此许可证适用于本仓库中的内容——注册表清单、插件打包内容、技能和本文档。它不授予使用 Melaya 服务本身的许可：使用托管于 api.melaya.org 的服务需要 Melaya 账户，并受条款约束。