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

适合 OpenCode AI 工作流的最佳 API

比较适合 OpenCode 的 API，按仓库、搜索与部署工作流筛选，并核对接入权限和故障处理。

搜索 GitHub 工具打开评估提示词

发布日期：2026年3月14日 · 由 QVeris 团队制作

On this page
深蓝色 OpenCode 工具工作流概念图：AI 助手使用编码终端、MCP Schema 枢纽和权限校验，接入代码仓库、搜索与数据库工具，汇总带来源证据的研究报告。
在 OpenCode 工作流中组合搜索、文档与数据库 API；将工具结果整理为研究报告前，核对权限、来源链接、时间戳及故障处理。

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

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

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

兼容性基线： 请查看 OpenCode 官方 MCP 文档，确认当前版本的本地与远程配置、OAuth、工具管理和调试方式。
#服务器最适合典型权限范围主要注意点
1QVeris API 与插件实时数据与 API 工具指定工具与服务商只开放所需操作
2GitHub API仓库、Issue 与 PR令牌与仓库范围避免宽泛写权限
3Brave Search API实时网络检索远程文档读取确认库与版本
4Playwright浏览器操作与验证指定站点与测试环境保护会话并审核表单提交
5Supabase APIsSupabase 项目工作项目与功能组优先连接开发项目
6文件系统限定范围的本地文件明确指定的目录不要暴露宽泛根目录
7网页获取简单 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

网页获取 API

最适合受控 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 配置最小但够用的工具集

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

生成可持续跟进的研究报告打开 OpenCode MCP 文档
OpenCode API：仓库上下文、CI 与交付 | QVeris Guides