参考

集成

Argus 支持 Model Context Protocol，所以一个本来就会用工具的 Agent 不必先学一套 API，就能驱动你的环境。连接过程不安装任何东西。

本页内容

通过 MCP 接入的 Agent

MCP 是编程 Agent 了解一个程序能做什么的方式。Agent 请求工具列表，拿回一份带名称、描述和参数结构的清单，然后调用它需要的那些——没有封装层，没有 SDK，也没有任何需要跟着更新日志同步的东西。

Argus 的服务器运行在启动器自身的应用包内部，以 ELECTRON_RUN_AS_NODE 启动。没有要安装的包，也没有新的东西在监听端口：它通过 stdin 和 stdout 用 JSON-RPC 与启动它的客户端对话，并代表你访问本地 API。

对大多数客户端，启动器会替你写好配置文件，并先把路径给你看。有两个客户端没有可写的配置文件，于是改为直接给出一段可粘贴的配置。

这是一个本地 API。它在运行 Argus 的那台机器上监听回环地址，机器之外的任何东西都到不了它。不存在托管在网上的 Web API。

API 和 MCP 工具在所有套餐上都可用，包括 Free。套餐决定一个工作区能有多少个环境、席位和自动化流程，但不决定 API 是否响应。这台服务器是什么、Agent 通过它能够到什么、它的边界在哪里，都在 MCP 页上；这里往下讲的是接线。

支持的客户端

编码智能体

Claude Code

Anthropic 的编码智能体命令行工具。在任意项目里把浏览器环境当作工具来驱动。

配置文件: ~/.claude.json
键名: mcpServers.argus

在任意项目里执行 /mcp，列表中应当出现 argus。

Codex

OpenAI 的编码智能体命令行工具。同一套工具，写进 Codex 自己的配置。

配置文件: ~/.codex/config.toml
键名: [mcp_servers.argus]

Codex 在启动时读取 MCP 服务器列表——问它有哪些工具，argus 的那些应当在其中。

Cursor

AI 代码编辑器。注册在 Cursor 的全局 MCP 配置里。

配置文件: ~/.cursor/mcp.json
键名: mcpServers.argus

打开 Cursor Settings → MCP：argus 应当在列表中并已启用。

Gemini CLI

Google 的编码智能体命令行工具。同一套工具，写进它自己的设置文件。

配置文件: ~/.gemini/settings.json
键名: mcpServers.argus

执行 /mcp，列表中应当出现 argus。

Windsurf

Codeium 出品的编辑器。注册后供 Cascade 使用。

配置文件: ~/.codeium/windsurf/mcp_config.json
键名: mcpServers.argus

打开 Cascade 的插件面板：argus 应当列在其中。

VS Code

Visual Studio Code 的 Agent 模式，通过它的用户级 MCP 配置接入。

配置文件: Code/User/mcp.json
键名: servers.argus

把聊天切到 Agent 模式并打开工具选择器——argus 的工具应当列在其中。

Zed

Zed 的 Agent 面板，通过它的上下文服务器设置接入。

配置文件: ~/.config/zed/settings.json
键名: context_servers.argus

查看 Agent 面板的设置：argus 应当出现在上下文服务器里。

自动化

OpenClaw

横跨多个聊天渠道的个人助理网关。

配置文件: ~/.openclaw/openclaw.json
键名: mcp.servers.argus

它在启动时加载配置——argus 应当出现在它的工具里。

手动配置

这两个没有 Argus 能替它们写的配置文件。接它们，就是把一段配置交到你手上，而不是假装已经替你接好了。

Hive

手动

多智能体运行环境。一次对大量浏览器环境跑质检与监控。

配置文件: its own .env
键名: environment variables

Hive 在启动时读取 .env——它的第一轮巡检就会用上这把密钥。

Any other MCP client

手动

任何会说 MCP 的客户端。自己把服务器配置块复制进它的配置文件。

配置文件: whatever your client reads
键名: mcpServers.argus

重启之后，你的客户端应当把 argus 列在它的 MCP 服务器里。

手动配置

上面除了 Hive 和「Any other MCP client」之外，Argus 都会替你写好这个块，并在动手之前先把文件路径给你看。如果你更愿意自己来，或者你的客户端不在名单上，它就是这个形状。

mcp.json

{
  "mcpServers": {
    "argus": {
      "type": "stdio",
      "command": "Argus Launcher",
      "args": ["<the path shown after you connect>"],
      "env": {
        "ELECTRON_RUN_AS_NODE": "1",
        "ARGYS_API_TOKEN": "<your key>",
        "ARGYS_API_BASE": "http://127.0.0.1:39219"
      }
    }
  }
}

Hive 则改为从它自己的 .env 里读取环境变量：

.env

ARGYS_API_BASE=http://127.0.0.1:39219
ARGYS_API_TOKEN=<your key>

配完之后重启客户端。它们每一个都在进程启动时读取自己的 MCP 配置，而 Argus 没有可发的重载信号。

Agent 拿到什么

143个工具，以及服务器在连接时交给模型的那段说明：

驱动 Argus 防关联浏览器环境。每个环境都是一个相互隔离的浏览器身份，拥有自己的代理、指纹和 Cookie 存储。惯常流程：argus_list_profiles，然后 argus_launch_profile，然后 argus_navigate / argus_read_page / argus_screenshot，最后 argus_close_profile。启动后的会话会带上该环境已有的全部身份，包括它的 Cookie——不要把这个环境本不该拥有的东西交给它。启动的返回里带有一个 `warnings` 数组：非空就意味着该环境共享它的 Cookie 集或代理已超出上限，请告知用户，而不是闷头开一整批；开批之前先调用 argus_sharing_report，一次调用就能看到全貌。这个工作区里还可能有「项目」：横跨环境、代理和自动化流程的具名工作，每个项目有自己的目标、一套规则，以及应用内助手为它维护的笔记和操作手册。用 argus_list_projects 查看有哪些项目，用 argus_project_context 取某个项目的简介和规则——在动这个项目的任何东西之前先读它们，因为它的约束就写在那里。其余文档都以资源形式暴露（argus://project/<id>/<path>），所以先列出它们，只读你需要的那几份。argus_delegate 把一个目标交给 Argus 自己的编排器，它已经载入了该项目的上下文。

有127个工具包着一个接口

argus_list_profiles

List profiles (optional ?folder=<id>)

argus_get_profile

Read one profile

argus_create_profile

Create a profile

argus_update_profile

Update name, status, tags, colour, avatar, folder, proxy mode, start URL or launch automation

argus_profile_notes

Read a profile's notes, newest first

argus_add_profile_note

Append a note to a profile

argus_assign_proxy

Put a profile on a proxy from the library

argus_sharing_report

Every cookie-set and proxy shared past its limit, with the limits themselves

argus_launch_profile

Open a profile for automation; returns its CDP url. Reuses a running session unless relaunch is set

argus_profile_session

Where a running profile's CDP endpoint is, without launching it

argus_close_profile

Close a session this key opened

argus_delete_profile

Move a profile to Trash (permanent: true to purge; the tool only soft-deletes)

argus_update_fingerprint

Re-roll or override a profile's fingerprint

argus_fingerprint_check

Check a running profile's fingerprint

argus_list_proxies

List proxies

argus_create_proxy

Add proxy

argus_update_proxy

Update a proxy

argus_check_proxy

Check reachability and egress IP

argus_delete_proxy

Remove a proxy

argus_reimport_proxies

Re-import proxies from a list of rows

argus_assign_cookie_set

Set which profiles launch with a cookie-set

argus_unassign_cookie_set

Detach profiles from whatever cookie-set they hold

argus_list_cookie_sets

The workspace's cookie sets, metadata only

argus_update_cookie_set

Change a cookie set's name, status, colour, folder or tags

argus_trash_cookie_sets

Move cookie sets to Trash

argus_list_trashed_cookie_sets

The cookie sets currently in Trash

argus_restore_cookie_sets

Bring cookie sets back out of Trash

argus_purge_cookie_sets

Permanently delete cookie sets from Trash

argus_list_automations

List the org's automations, with step counts

argus_list_recipes

List the prebuilt recipes, and which ones this workspace has set up

argus_set_up_recipe

Create one prebuilt recipe, plus any tables it needs

argus_list_scrapers

The scraper catalogue, and what this workspace has run

argus_get_scraper

One scraper's form and the columns it produces

argus_sample_scraper

A dry run: one page, nothing written

argus_run_scraper

Run a scraper; returns a run id immediately

argus_scraper_runs

Past runs of one scraper, newest first

argus_automation_schema

The step catalogue: every step type, its fields and how they validate

argus_get_automation

Read one automation, including its full step tree

argus_create_automation

Create an automation. Steps are validated before anything is stored

argus_update_automation

Change an automation's name, description, steps or wiring

argus_delete_automation

Move an automation to Trash. It stops running on launch and on its schedule

argus_run_automation

Run an automation against a profile, launching it if needed

argus_automation_runs

Recent runs of one automation, with status and errors

argus_list_schedule_entries

Every scheduled workflow in the workspace

argus_create_schedule_entry

Create a scheduled workflow or AI task

argus_update_schedule_entry

Change a scheduled workflow's time, steps, colour or enabled state

argus_delete_schedule_entry

Delete a scheduled workflow

argus_schedule_history

What the calendar actually ran over a range of days

argus_keep_awake

Whether this computer is being held awake for the schedule

argus_set_keep_awake

Hold this computer awake so scheduled runs are not missed

argus_schedule_notifications

Whether the signed-in user hears about their scheduled days

argus_set_schedule_notifications

Turn the schedule's Telegram messages on or off

argus_list_event_triggers

Every event trigger in the workspace

argus_create_event_trigger

Create an event trigger

argus_update_event_trigger

Change an event trigger's watch settings, target or enabled state

argus_delete_event_trigger

Delete an event trigger

argus_list_datasets

The workspace's datasets, with their declared columns

argus_create_dataset

Create a dataset, optionally with starting columns

argus_update_dataset

Change a dataset's name, icon, colour or folder

argus_update_dataset_schema

Replace a dataset's declared column list

argus_update_dataset_options

Edit one choice column's options

argus_sample_rows

A page of a dataset's rows

argus_query_rows

Query a dataset's rows by where conditions, optionally aggregated

argus_add_rows

Append rows to a dataset

argus_update_rows

Rewrite dataset rows in place by id

argus_delete_rows

Delete dataset rows by id or by a where filter

argus_trash_datasets

Move datasets to Trash

argus_list_trashed_datasets

The datasets currently in Trash

argus_restore_datasets

Bring datasets back out of Trash

argus_purge_datasets

Permanently delete datasets from Trash

argus_list_projects

The workspace's projects, what each holds, and the index of its brain

argus_project_context

One project's goal, brief and rules, plus the titles of its other documents

argus_delegate

Hand a goal to Argus's own orchestrator, inside a project's context

argus_list_connectors

The workspace's connectors, and the field list of every kind

argus_create_connector

Add a connector. Owner-only, like the Connectors view

argus_update_connector

Rename a connector, change its config or make it the default

argus_delete_connector

Delete a connector

argus_test_connector

Send a real test message, or a one-word AI completion

argus_list_folders

The folders profiles, proxies, cookie sets and automations are filed in

argus_list_statuses

Every status label a profile, proxy or cookie set can carry

argus_get_proxy_share_limit

This machine's proxy-sharing threshold

argus_set_proxy_share_limit

Change this machine's proxy-sharing threshold

argus_telegram_status

Whether the notification bot is set up, and who is subscribed

argus_set_telegram_pref

Subscribe the signed-in user to one automation's outcomes

argus_set_telegram_bot

Set the workspace's notification bot. Owner-only

argus_table_columns

What each table shows, and every column it could show

argus_set_table_columns

Show or hide columns on a table

argus_skills_schema

The vocabulary a skill is written in: tool packs, entry tabs, shelf ids

argus_list_skills

List the assistant's skills, built-in and custom

argus_get_skill

Read one skill, including its full brief

argus_save_skill

Create a custom skill, or edit a built-in one

argus_delete_skill

Delete a custom skill, or reset a built-in to its shipped brief

argus_trash_profiles

Move profiles to the trash

argus_list_trashed_profiles

Profiles currently in the trash

argus_restore_profiles

Restore profiles from the trash

argus_purge_profiles

Delete trashed profiles permanently

argus_switch_tab

Bring one of a profile's tabs to the front

argus_new_tab

Open a new tab in a launched profile

argus_page_recording

What has been done to this page so far

argus_save_page_recording

Save what was done to a page as an automation

argus_dedupe_rows

Remove duplicate rows

argus_search_automations

Find automations by name, step or connector

argus_automation_summary

What one automation does, without its full document

argus_schedule_day

One day of the calendar

argus_trigger_history

What has fired recently

argus_create_project

Start a project

argus_add_to_project

Put records into a project

argus_remove_from_project

Take records out of a project

argus_read_project_doc

Read one project document

argus_write_project_doc

Write a project document

argus_delete_project_doc

Delete a project document

argus_make_plan

Lay out a multi-step plan

argus_delegate_many

Hand several goals to subagents at once

argus_list_mailboxes

The mailboxes this workspace can read

argus_list_messages

List a mailbox folder

argus_read_message

Read one message

argus_read_new_message

Wait for a message that has not arrived yet

argus_open_compose

Start a draft

argus_list_compose

Drafts that are open right now

argus_set_compose_fields

Fill in a draft

argus_send_compose

Send a draft

argus_close_compose

Discard a draft

argus_list_docs

The knowledge-base index

argus_read_doc

Read one knowledge-base article

argus_search_docs

Search the knowledge base

argus_get_context

What this workspace actually holds

argus_recent_errors

What has gone wrong lately

有16个直接驱动页面，背后没有任何接口

argus_connection_status

Confirm this MCP connection works, and say as whom

argus_page_snapshot

The interactive elements on a page, each with a selector to act on it

argus_click

Click an element, or a point, in a running profile's page

argus_type

Type into a field in a running profile's page

argus_press_key

Press a single key in a running profile's page

argus_scroll

Scroll a running profile's page

argus_wait_for

Wait until a page reaches a condition

argus_extract

Read values out of a running profile's page

argus_select_option

Choose an option in a dropdown

argus_list_tabs

List the open pages in a running profile

argus_navigate

Point a page at a URL and wait for it to settle

argus_go_back

Go back, or forward, in a page's own history

argus_reload

Reload a page and wait for it to settle

argus_read_page

Read a page's visible text, whole or by CSS selector

argus_screenshot

Screenshot a page — JPEG by default, PNG on request

argus_eval

Evaluate a JavaScript expression in a page and return its value

还有4个接口根本没有对应的工具——那些破坏性的和批量的。它们列在 API 参考里，标着 HTTP only。

自动化连接器

连接器是自动化流程可以触及的外部服务：一个用来提问的模型、一个发送答案的去处，以及一次运行产出的数据行的落脚点。步骤里只保存连接器的 id，别的什么都不存，所以密钥只在一个地方改，用到它的每一条自动化流程都跟着变。

十二个 AI 条目一共只用了两种通信协议。其中十一个说 OpenAI 的 chat-completions 格式，因为它们各自都提供了 OpenAI 兼容的端点；真正不一样的只有 Claude。十二个里有两个跑在你自己的机器上，完全不需要密钥。

数据连接器是「保存数据行」和「载入数据行」这两个步骤指向的地方。每个连接器除了凭据之外还带着自己的容器——Sheets 连接器持有电子表格，Airtable 连接器持有 base——所以一个步骤只需要指名一张表、一个标签页、一个键或一个文件。

验证码连接器是「破解验证码」步骤购买答案的地方。同样是两个条目、两种通信协议，因为这个市场上的每家服务都抄了其中之一。这是唯一按调用花钱的类别，所以它的「测试」只读取账户余额，不会真的去解一道题——而两者之一的 CapMonster Pro 跑在你自己的机器上，每次破解完全不收费。

连接器的凭据保存在你的工作区里，工作区内任何能打开连接器列表的人都读得到——而且它们会经由本地 API 原样返回，所以一把 Argus API 密钥等同于它能读到的那些凭据。Argus 在自己的界面里会把它们打码，但那只是方便，不是安全边界——给连接器的密钥，应当是该服务肯签发的最窄的一把。

接口地址: http://127.0.0.1:1234/v1
模型: local-model
需要: 无需凭据——它运行在你自己的机器上

Ollama

兼容 OpenAI

接口地址: http://127.0.0.1:11434/v1
模型: llama3.1
需要: 无需凭据——它运行在你自己的机器上

Other

兼容 OpenAI

需要: 你自己的接口地址；如果它要密钥，再加一把密钥

任何能响应 POST {base}/chat/completions 的服务。基础地址由你填写。

消息通知

notify 步骤把消息发到哪里，一次运行结束时又从哪里告诉你。每个服务一个适配器：和模型厂商不同，聊天服务从来没有统一过通信格式。

需要: 机器人 Token 和 chat ID

从 @BotFather 获取。机器人必须先往该聊天发过一次消息，或者已经在群里。群的 ID 是负数。

去哪里拿密钥

Slack

需要: Incoming Webhook 地址

这个地址本身就是凭据——谁拿到它，谁就能往频道里发消息。

去哪里拿密钥

Discord

需要: Webhook 地址

去哪里拿密钥

需要: Cloud API 的电话号码 ID、访问令牌，以及一个收件人

自由格式的消息只能发给过去 24 小时内给这个号码发过消息的人；超出这个窗口，WhatsApp 要求使用预先审核过的模板。

去哪里拿密钥

Email (SMTP)

需要: 主机、端口、发件人和收件人——中继若要求，再加用户名和密码

465 端口直接以 TLS 连接；其他端口先明文连接，再通过 STARTTLS 升级。

数据库与文件

saveRows 步骤把一次运行的结果写到哪里，loadRows 又从哪里把工作清单读回来。所有写入都从启动器发出，绝不从浏览器环境的页面发出——所以落进你自己数据库的一行，不会记到某个身份的代理账上。

Supabase

需要: 项目 URL 和 service role 密钥

要用 service_role 密钥，不要用 anon 密钥——anon 受行级安全策略约束，没有对应策略时通常什么也写不进去。

去哪里拿密钥

Postgres

需要: 主机、数据库、用户和密码

默认会校验 TLS。使用自签名证书的托管数据库需要 require 模式：它只加密，不校验。

Firebase

需要: 服务账号的项目 ID、client email 和私钥

服务账号需要 Cloud Datastore User 角色。Firestore 没有固定表结构，因此列名是自由文本。

去哪里拿密钥

Redis

需要: 主机——服务器若要求，再加密码、数据库编号和 TLS

行会以 JSON 文档的形式追加进一个 Redis 列表，一行一条，读回时按写入顺序。托管 Redis（Upstash、Redis Cloud）只走 TLS——请选 verify-full。

Google Sheets

需要: 服务账号的 client email 和私钥，再加那份表格

把表格以编辑者权限共享给服务账号的邮箱地址——服务账号和人一样，文件没共享给它，它就看不到。

去哪里拿密钥

Notion

需要: 内部集成 Token

逐一打开你要写入的数据库，在 ••• → Connections 里连接该集成。光有 Token 什么也看不到。

去哪里拿密钥

Airtable

需要: 个人访问令牌和对应的 base

令牌需要 data.records:read、data.records:write 和 schema.bases:read 权限，并且能访问这个 base。

去哪里拿密钥

Local file

需要: 本机上的一个文件夹

csv 用任意表格软件都能打开。jsonl 每行追加一个对象，运行中途崩溃也不会丢；json 每次都重写整个数组。

Meta Lead Ads

需要: 带 leads_retrieval 权限的主页或系统用户访问令牌，再加主页 ID

只读：线索会载入自动化流程和数据集，绝不会回写到 Meta。

去哪里拿密钥

验证码破解

solveCaptcha 步骤向谁买答案。这个步骤从实时页面上读出 site key，再把令牌注回页面，但发给服务商的请求是从启动器出去的——既不带浏览器环境的代理，也不带它的 Cookie，服务商只被告知页面地址和它的 site key，别的什么都没有。这是唯一一类按次花钱的连接器，所以它的 Test 读的是账户余额，而不是真去破一个码。

2Captcha

需要: API 密钥

按次计费。页面地址和它的 site key 由启动器发给服务商，不走浏览器环境的代理。

去哪里拿密钥

CapMonster

需要: 一个服务器地址；用云端版还要一把客户端密钥

一个 API 背后是两个产品：CapMonster Pro 跑在你自己的机器上（127.0.0.1:9090），不按次收费；CapMonster Cloud 是付费的，需要密钥。

去哪里拿密钥

邮件投递

sendBroadcast 步骤通过谁把邮件发出去，而且它是唯一被允许指定这类连接器的步骤。和消息通知分开是有意的：消息连接器是告诉你一次运行结束了，而这一类是把邮件发给别人。它走的是启动器自己的网络连接，而不是某个浏览器环境的代理——这是工作区在和一个自己持有账号的厂商对话，不是某个身份在网站上行动。

哪一份名单可以走它，不是一个开关。每家服务商的使用条款都禁止冷邮件、外购名单和抓取来的联系人数据，而代价是账号本身，不只是一封退信。冷邮件要改走 sendEmail 步骤和你自己的邮箱：先养号、设上限，并且经由每个身份各自的代理发出。