跳到主要内容

服务凭据

在 Settings → Credentials 为实际发起请求的服务配置凭据。Codex 订阅提供模型访问,不提供 OpenAlex、GitHub 或自定义 MCP 账号。

内置服务​

服务字段与用途验证方式
GitHubSkill 发现/导入用 Personal access tokenConnect/Manage 后使用目标仓库操作验证
Literature access联系邮箱及可选 NCBI API key保存真实联系信息;支持的 NCBI 请求中密钥可选
OpenAlexLiterature 中 OpenAlex 操作的可选 API keyValidate、保存,再运行小查询
Unpaywall查询全文位置所需联系邮箱使用文献联系邮箱,不填写虚构地址

Connect 打开未配置服务,Manage 管理已有配置,Desktop only 表示需要桌面环境。已存储标记不是密钥明文。

配置可选的 OpenAlex 密钥​

从 v0.33.1 起,OpenAlex 查询不再强制要求 API key。可以先运行一个小查询;服务方的限额、认证和访问策略仍适用。应用允许不带密钥发起请求,不代表无限额度或保证每次请求成功。

需要使用自己的密钥时,打开 Settings → Credentials → OpenAlex(也可从 Literature Graph 的 Manage credentials 进入),填写 API key,选择 Validate,验证成功后 Save。密钥只用于 api.openalex.org。已有密钥可通过 Remove key 移除;替换输入框不会显示保存的密钥。

遇到系统安全存储错误时,先恢复凭据库,再保存。收到 429 时查看服务的额度与重试信息,不要把限流当成必须补密钥。

自定义 Connector 凭据​

在此创建凭据,再到 Connector 配置选择其名称。修改或移除共享凭据前先核对使用者。

New credential 表单​

字段或按钮操作
Name为凭据设置便于识别的本地名称
Type选择 API key、Access token、OAuth
Valuekey/token 的遮罩输入框;必填项为空时 Save 禁用
OAuth → Resource URL填写准确资源地址,Connector 按资源 URL、传输方式和注册配置匹配
Advanced → Transport选择服务要求的传输方式,当前默认是 Streamable HTTP
Scopes用空格或逗号分隔作用域
Use a pre-registered client展开 Authorization server URL、Client ID、Callback URL、Client secret
Callback URL / Copy当前默认 http://127.0.0.1/oauth/callback,可复制用于服务注册,也可展开自定义回调选项
Discovery适用时发现服务器元数据;发现成功本身不是登录成功
Cancel / Save放弃草稿或保存有效配置

OAuth 高级注册字段

在自定义 Connector 中,将命名凭据绑定到请求头、环境变量或 OAuth 选择器。名称用于引用,不应把密钥放进描述或项目指令。导出的可移植配置以占位符替换密钥;保存凭据后仍需实际服务测试才能确认可用。

验证与排错​

保存后执行一次小范围操作,读取实际响应。credential_required 表示缺少已配置凭据;401 需检查认证,403 需检查权限/策略,不能一律靠换密钥解决。429 涉及限流或用量。保留服务正文,参见排错。

移除凭据可能影响所有绑定的 Connector。Connector 和 Specialist 导出不会携带现成密钥/信任,接收端应重新配置。不要将密钥写入 Skill、提示词、截图或 issue。

OpenAlex 密钥可选;OAuth Connector 仍需完成对应服务登录。处理显示的认证错误后,再重试同一小请求。

实现依据: CredentialsPanel.tsx, ConnectorAddForm.tsx。

可通过本地认证的 CLI/SDK 凭据管理创建/更新共享凭据。Linux headless 可显式选择未加密文件存储,桌面凭据仍遵循正常 OS 存储行为;此选项不解决 Compute 密码存储,也不发起首次 OAuth 登录。

打开官方 API Key 页面​

OpenAlex 和 NCBI 的凭据表单提供官方密钥页面入口。在服务方完成账户操作后,返回表单,验证并保存所需密钥。打开链接不会自动保存密钥或执行查询;是否需要密钥取决于服务与具体操作。