QVeris
接入我正在用的 AI
OpenCode API GuideOpenCode API 指南

Best APIs to Use with OpenCode for AI Workflows适合 OpenCode AI 工作流的最佳 API

Compare practical APIs for OpenCode workflows by data fit, freshness, permissions, latency, and production controls.

从数据匹配度、时效、权限、延迟和生产控制等方面，对比适合 OpenCode 工作流的实用 API。

Test a OpenCode workflow测试 OpenCode 工作流Read the API integration docs阅读 API 集成文档
OpenCode agent hub connected through permission gates to web, documents, repositories, browser, database, files, memory, and location data
每个 API 集成 都是一条能力与权限边界，而不是越多越好的插件收藏。

快速结论：按结果选择，不追求数量

对大多数 OpenCode 项目而言，先接入一种能补齐重复性工作流缺口的外部能力即可。QVeris 可用于发现 API 工具；涉及代码仓库时加入 GitHub，需要最新网页证据时加入 Brave Search，需要浏览器验证时加入 Playwright。数据库、文件系统、支付和协作服务会暴露更多数据与操作，应按项目单独授权。

OpenCode 通过 opencode.json 或 opencode.jsonc 中的 mcp 配置支持本地与远程 MCP Server。MCP 工具会占用模型上下文，因此范围更小、与任务直接相关的工具集通常更容易选择、保护和审计。

兼容性基线： 请查看 OpenCode 官方 MCP 文档，确认当前版本的本地与远程配置、OAuth、工具管理和调试方式。
#Server最适合典型权限范围主要注意点
1QVeris API & Plugin实时数据与 API 工具指定工具与服务商只开放所需操作
2GitHub API仓库、Issue 与 PR令牌与仓库范围避免宽泛写权限
3Brave Search API实时网络检索远程文档读取确认库与版本
4Playwright浏览器操作与验证指定站点与测试环境保护会话并审核表单提交
5Supabase APIsSupabase 项目工作项目与功能组优先连接开发项目
6Filesystem限定范围的本地文件明确指定的目录不要暴露宽泛根目录
7Fetch简单 URL 内容抓取网络读取将网页视为不可信输入
8Stripe APIs支付与账单测试模式下的账单操作资金操作必须审批

适合 OpenCode 的 8 个最佳 API 集成

本清单优先考虑实际用途、文档与维护情况、权限范围以及与编程工作流的匹配度；它是一份场景清单，而不是通用性能排名。

1

QVeris API & MCP

最适合统一发现工具

当 OpenCode 需要发现并测试明确的外部操作，又不想为每个服务商维护独立适配器时，可优先使用 QVeris。

2

GitHub APIs

最适合代码仓库工作流

可先让 OpenCode 只读访问 Issue、PR、检查与 Release；合并和分支策略变更应保留人工审批。

3

Brave Search API

最适合获取最新网页证据

搜索适合查询快速变化的文档与错误信息；返回网页必须视为不可信输入，并保留来源 URL。

4

Playwright

最适合浏览器验证

本地 UI 检查以及无法仅通过 API 验证的流程，可以使用浏览器自动化。

5

Supabase APIs

最适合应用数据

数据库与存储操作应限制范围、验证 RLS，并将开发凭证与生产凭证分离。

6

Google Workspace APIs

最适合文档与协作

应使用细粒度 OAuth 权限，并在 OpenCode 发送邮件、编辑共享文档或修改日历前提供预览与确认。

7

Fetch APIs

最适合受控 URL 抓取

小型 Fetch 工具适合读取已知文档 URL，但应限制域名、重定向、响应大小和内容类型。

8

Stripe APIs

最适合账单工作流

应从测试模式开始，验证 Webhook 签名并使用幂等键；扣款、退款和订阅变更必须经过审批。

按缺失能力选择

工作流推荐起点按需增加
软件交付GitHub + Brave Search API端到端验证再加 Playwright
Supabase 应用Supabase + Brave Search APIIssue/PR 流程再加 GitHub

在 OpenCode 中安全配置 MCP 工具

应以 OpenCode Config 作为配置事实来源。在 mcp 下添加一个具名 Server，先连接非生产环境，确认认证状态，再通过当前的 permission 规则控制各项工具权限。

  1. 本地进程使用 type: "local" 与命令数组；远程 MCP Server 使用 type: "remote" 与 URL。
  2. 通过环境变量引用密钥，不要把明文凭证提交到配置文件。
  3. 运行 opencode mcp list 查看已配置 Server 及其认证状态。
  4. OAuth Server 使用 opencode mcp auth <server-name>；远程认证或发现失败时使用 opencode mcp debug <server-name>。
  5. 在 permission 中将敏感或会改变状态的工具模式设为 "ask" 或 "deny"。
  6. 先使用有代表性的非生产数据测试，再逐步扩大权限范围。
opencode mcp list
opencode mcp auth <server-name>
opencode mcp debug <server-name>
opencode mcp logout <server-name>

配置与命令可能随版本变化，请以 当前 OpenCode MCP 文档 为准，并同时查看 权限配置文档。

OpenCode MCP 安全检查清单

  • 安装前核对维护者、仓库、包名、版本记录与官方文档。
  • 固定或审查版本；便捷标签适合评估，但不能替代供应链策略。
  • 使用按 Server 的工具过滤，并优先开放资源范围明确的只读操作。
  • 网页、Issue、文档、数据库记录和工具描述都可能包含提示注入，应视为不可信内容。
  • 使用合规的环境变量或密钥引用机制保存凭证，并从日志中脱敏。
  • 将读取、写入、发布、支付、删除与生产访问划分为不同审批等级。
  • 记录 Server 身份、工具名、决策、结果状态与延迟，但不记录无必要的个人数据。
  • 预先设计停用路径；单个异常或受损 Server 不应拖垮整个智能体。

常见问题

OpenCode 能连接外部 API 吗？

可以。OpenCode 能使用本地或远程 MCP Server，开发者也可以用 TypeScript 或 JavaScript 创建自定义工具，再由工具调用 API 客户端或脚本。

应该先接入哪个 API？

先选择能补齐一个重复性能力缺口的最小集成：工具发现可考虑 QVeris，仓库工作选择 GitHub，最新网页证据选择 Brave Search，浏览器验证选择 Playwright。

OpenCode 应使用多少外部工具？

没有统一上限。当工具开始重叠、选择变得不稳定、上下文占用增加，或权限难以审计时，就应该缩减工具集。

OpenCode 可以自动批准 MCP 工具吗？

OpenCode 提供自动批准模式，但明确的 deny 规则仍会生效。为了降低风险，敏感操作和会改变外部状态的工具应设为 ask 或 deny，不应依赖不受限制的自动批准。

API 集成和 OpenCode Skill 是一回事吗？

不是。Skill 提供可复用的指令，MCP Server 或自定义工具则暴露可调用能力。Skill 可以进一步说明 OpenCode 应在何时、如何使用范围明确的工具。

为 OpenCode 配置最小但够用的工具集

先确定一个缺失能力，核对来源与权限，用代表性数据测试；只有完整工作流可靠后，才扩大工具范围。

在 QVeris 中测试数据工作流打开 OpenCode MCP 文档
适合 OpenCode AI 工作流的最佳 API | QVeris Guides