Skip to main content

Broker API MCP

机器翻译译自英文（docs.alpaca.markets）本页 49 段已全部译完


🚧 Beta

Broker API MCP Server 处于 beta 阶段，正在向选定的经纪合作伙伴推出。随着我们采纳合作伙伴的反馈，行为、可用操作和同意体验可能会发生变化。在 beta 期间，只有 Broker Dashboard 超级用户才能授权和使用该连接——请参阅谁可以使用它（超级用户）。

你可以做什么

  • 针对 Broker API 数据提问。 在实盘环境中，使用读取操作查找账户、检查账户状态和资料详情、审阅交易账户状态、检查购买力和现金、列出持仓、获取组合历史、审阅活动并检查转账。
  • 发现正确的端点和模式。 内置的 OpenAPI 发现功能让助手可以搜索 Broker API 操作、检查必需参数，并使用结构化输入调用端点。
  • 获得具备文档感知的答案。 精选的 Alpaca 文档和 API 参考查询工具可回答有关指南、端点行为、请求结构、响应字段和示例用法的集成问题。
  • 在沙盒中测试完整的经纪商工作流。 沙盒公开了用于开户、入金、转账、交易、自选列表、文档、期权、再平衡、资金划转、即时入金和 IPO 的读取和写入操作。
  • 快速创建合成沙盒账户。 create_sandbox_account 工具会生成具有有效默认值的测试账户，并可选择包含 KYC 或账户状态固定结果，用于演示、QA 和集成测试。

谁可以使用它（超级用户）

Broker MCP 通过 Broker Dashboard 中的 OAuth 授权连接到你的公司的 Broker API。批准该授权需要 manage_keys 权限，目前只有 Superuser 角色拥有此权限。

在邀请队友进行测试之前，请确认他们是否能在你的团队内实际授权该连接。

环境

有两个托管端点。每个映射到不同的对应方，并使用其自己的 OAuth 客户端——沙盒和实盘凭证不能互换。使用沙盒来测试写入、账户创建、订单和入金。

环境MCP 端点
沙盒https://broker-api.sandbox.alpaca.markets/mcp
实盘https://broker-api.alpaca.markets/mcp

设置

从任何支持远程（OAuth）服务器的 MCP 客户端进行连接。每个客户端都通过相同的 OAuth 流程进行授权：你启动连接，超级用户在 Broker Dashboard 中批准同意请求，然后客户端即获得授权。

Cursor

Cursor 提供了 Alpaca 插件：

  1. 打开命令面板：Cmd + Shift + P（macOS）/ Ctrl + Shift + P（Windows/Linux）。
  2. 输入 Open Customize 并选择匹配的选项。
  3. 点击 Browse Marketplace。
  4. 点击 Add Marketplace，然后从搜索栏右侧的下拉菜单中选择 Import from GitHub。
  5. 输入插件仓库 URL：https://github.com/alpacahq/agentic

Claude Code（CLI）

此外还提供 Claude Code 插件。添加市场：

claude plugin marketplace add alpacahq/agentic

要安装 MCP 服务器：

  1. 使用 claude 启动新会话，然后运行 /plugin。
  2. 打开 Marketplaces 选项卡并选择 alpaca-plugins。
  3. 选择 Browse plugins，选择 alpaca-broker，然后安装它。
  4. 运行 /reload-plugins 以加载它。
  5. 再次运行 /plugin，打开 Installed 选项卡，并确认列出了 alpaca-broker。

要启用服务器，请在聊天中运行 /mcp。你将看到 plugin:alpaca-broker:alpaca-broker 和 plugin:alpaca-broker:alpaca-broker-sandbox；选择任一即可启动其 OAuth 流程。

ChatGPT（网页版）

  1. 转到 Settings → Apps → Advanced Settings 并启用 developer mode。
  2. 在同一面板中，点击 Create App 并使用 MCP URL（实盘或沙盒）填写表单。
  3. 点击 Connect 并通过 OAuth 流程登录。

VS Code

在 .vscode/mcp.json 中添加任一或两个服务器：

{
  "servers": {
    "alpaca-broker-mcp": {
      "type": "http",
      "url": "https://broker-api.alpaca.markets/mcp"
    },
    "alpaca-broker-mcp-sandbox": {
      "type": "http",
      "url": "https://broker-api.sandbox.alpaca.markets/mcp"
    }
  }
}

然后打开命令面板（Cmd + Shift + P / Ctrl + Shift + P），运行 MCP: List Servers，选择 alpaca-broker-mcp 或 alpaca-broker-mcp-sandbox，然后点击 Start Server 触发 OAuth 流程。

验证

连接后，询问你的助手：

“查找 user@example.com 的账户，并总结其状态、购买力、持仓和近期活动。”

如果你收到由 API 支持的摘要，则说明服务器已连接。

工作原理

服务器不会将数千个端点工具加载到模型的上下文中，而是使用 CodeMode 发现流程。助手会：

  1. search — 根据意图查找相关的 Broker API 操作。
  2. get_schema — 检查必需参数、类型和响应结构。
  3. execute — 使用结构化输入调用端点（受环境的读/写策略约束）。

这可以保持工具选择的准确性并减少上下文膨胀。

可用工具

分组工具备注
端点发现与执行search, get_schema, execute由 OpenAPI 支持
文档与 API 参考search_alpaca_docs, fetch_alpaca_doc, search_alpaca_api_specs, list_alpaca_api_endpoints, get_alpaca_endpoint_docs只读文档/规范查询
沙盒实用工具create_sandbox_account仅限沙盒

服务器与来自 docs.alpaca.markets 的公开 Broker OpenAPI 规范同步。流式传输和重定向/下载操作被排除在外，因为它们不能作为请求/响应工具运行。

示例提示词

控制平面（对账户进行操作）：

  • “查找 user@example.com 的账户，并总结其状态、购买力、持仓和近期活动。”
  • “显示该账户上个月的投资组合历史。”
  • “检查该账户的近期转账，并总结任何待处理或失败的项目。”
  • “创建一个最终处于需要采取行动的 KYC 状态的沙盒账户，用于演示。”
  • “在沙盒中创建测试账户，然后检索其状态。”

数据平面（理解 API）：

  • “我应该使用哪个端点来创建 ACH 关系，需要哪些字段？”
  • “向我展示创建 Broker API 账户的端点和必填字段。”
  • “根据文档，创建沙盒账户的最小 curl 命令是什么？”
  • “搜索检索账户文档的端点，检查模式，并解释响应。”

安全与环境策略

  • 撤销访问权限。 可以从 Broker Dashboard（Team Management）查看和撤销授权。移除用户角色也会在下次令牌刷新时撤销其访问权限。
  • API 密钥安全。 连接使用 OAuth——切勿将 API 密钥或机密粘贴到聊天中。
  • 审查 AI 建议的操作。 在任一环境中启用写入的地方，请在运行任何变更操作之前进行确认。

已知限制（Beta）

  • IP 过滤器。 如果你的对应方配置了 IP 过滤器，托管的 MCP 连接目前将无法工作。这是我们计划解决的已知限制。
  • 仅超级用户可授权。 更广泛的基于角色的授权（将同意映射到现有角色）已在计划中；目前只有超级用户可以授权。
  • 生产环境为只读。允许写入操作计划在不久的将来实现。

资源

免责声明

由我们的 MCP 服务器和连接的 AI 智能体生成的见解仅供教育和信息目的，不应视为投资建议。请自行进行尽职调查，并在确认任何 AI 建议的操作之前进行审查。

AI 翻译查看英文原文