OpenCode 全局配置记录 (插件 / MCP / Skill)

type

Post

status

Published

date

Feb 24, 2026

slug

opencode-global-config-record-plugin-mcp-skill

summary

我的OpenCode 全局配置记录

什么是 OpenCode 全局配置

OpenCode 的全局配置让你在所有项目中都能使用相同的设置，包括：

插件 (Plugin): 扩展 OpenCode 功能的模块

MCP 服务器: 外部工具集成（如 Notion、GitHub、Sentry 等）

Skill: 自定义技能，让 AI 在特定领域发挥更强能力

一、配置文件基础

1.1 全局配置文件位置

这是一个 JSON/JSONC 格式的配置文件。

1.2 你的全局配置文件内容

1.3 配置优先级

OpenCode 会合并多个配置位置，后面的会覆盖前面的：

优先级	位置	说明
1	Remote config (`.well-known/opencode`)	组织默认配置
2	Global config	`~/.config/opencode/opencode.json` ← 你的
3	Custom config	`OPENCODE_CONFIG` 环境变量
4	Project config	项目目录下的 `opencode.json`
5	Inline config	`OPENCODE_CONFIG_CONTENT` 环境变量

二、插件 Plugin

2.1 什么是插件

插件是扩展 OpenCode 核心功能的模块。你可以在配置文件中添加插件来增强 OpenCode 的能力。

2.2 你的插件配置

你当前安装了 oh-my-opencode 插件，这是一个 Sisyphus 编排框架，包含丰富的工作流和任务处理能力。

2.3 安装插件

在 plugin 数组中添加插件名称和版本：

三、MCP 服务器

3.1 什么是 MCP

MCP (Model Context Protocol) 是一个开放标准，允许 AI 工具连接外部服务。通过 MCP，你可以让 OpenCode 直接与 Notion、GitHub、Sentry 等服务交互。

3.2 你的 MCP 配置

你配置了 Notion MCP，这是一个远程服务器，使用 OAuth 进行认证。

3.3 MCP 类型

远程 MCP (Remote)

本地 MCP (Local)

3.5 MCP 认证

OAuth 认证

手动认证

认证后，OpenCode 会将 Token 安全存储在 ~/.local/share/opencode/mcp-auth.json。

3.6 启用/禁用 MCP

全局控制

按代理控制

3.7 MCP 选项说明

选项	类型	说明
`type`	string	`local` 或 `remote`
`url`	string	远程 MCP 的 URL
`command`	array	本地 MCP 的启动命令
`enabled`	boolean	是否启用
`headers`	object	请求头
`oauth`	object/boolean	OAuth 配置
`environment`	object	环境变量（本地 MCP）
`timeout`	number	超时时间（毫秒）

四、Skill 技能

4.1 什么是 Skill

Skill 是自定义技能，让 OpenCode 在特定领域具备专家级能力。每个 Skill 包含：

SKILL.md: 技能定义和指令

scripts/: 可执行的脚本

references/: 参考文档

assets/: 资源文件

4.2 你的已加载 Skills

Skill	路径
`remotion-best-practices`	`~/.config/opencode/skills/remotion-best-practices`
`skill-creator`	`~/.config/opencode/skills/skill-creator`

remotion-best-practices: 用于 Remotion 视频制作，包含字幕、FFmpeg、音频可视化、3D、图表等规则。

skill-creator: 用于创建和编辑 OpenCode Skill 的指导技能。

4.3 Skill 存放位置

作用域	路径
全局	`~/.config/opencode/skills/<name>/SKILL.md`
全局 (兼容 Claude)	`~/.claude/skills/<name>/SKILL.md`
全局 (兼容 Agents)	`~/.agents/skills/<name>/SKILL.md`
项目	`.opencode/skills/<name>/SKILL.md`
项目 (兼容)	`.claude/skills/<name>/SKILL.md`

4.4 SKILL.md 格式

4.5 Skill 目录结构

4.6 Skill 触发方式

当你的请求与 Skill 的描述匹配时，OpenCode 会自动加载对应的 Skill。你也可以在对话中明确指定使用某个 Skill。

五、完整配置示例

5.1 你的当前完整配置

六、常用命令汇总

MCP 命令

命令	说明
`opencode mcp auth <name>`	触发 MCP OAuth 认证
`opencode mcp list`	查看所有 MCP 及状态
`opencode mcp logout <name>`	删除 MCP 凭据
`opencode mcp debug <name>`	调试 MCP 连接

常用 MCP 认证

八、你的配置总结

类型	配置
插件	`oh-my-opencode@latest`
MCP	`notion` (远程, OAuth)
Skills	`remotion-best-practices`, `skill-creator`

最后更新：2026年2月24日