mcpField
A
api-setup

api-setup

github.com/block开发25165 次安装18 周前更新
代码仓库

关于 api-setup

用于按标准配置模板建立新 API 集成的技能，涵盖创建集成目录、填写凭据、测试连接以及排查常见故障。

主要功能

  1. 01创建集成目录
  2. 02JSON 配置模板
  3. 03配置 API 凭据和端点
  4. 04验证连接
  5. 05排查超时与身份验证问题

适用场景

  1. 01开始新的 API 集成
  2. 02配置 API 密钥和端点
  3. 03排查连接超时或 401/403 错误

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/block/agent-skills --skill api-setup

安装后在 Claude Code 中输入/api-setup确认已加载。

附带文件setup.shtemplates/config.template.json

详细介绍

API 设置

本技能可帮助你使用标准配置设置新的 API 集成。

步骤

  1. 运行 setup.sh <api-name> 以创建集成目录
  2. 将 templates/config.template.json 复制到你的集成目录
  3. 使用你的 API 凭据更新配置
  4. 测试连接

配置

配置模板包含：

  • api_key：你的 API 密钥（从提供商的仪表盘获取）
  • endpoint：API 端点 URL
  • timeout：请求超时时间（秒，默认值：30）

验证

设置完成后，请验证：

  • 配置文件是有效的 JSON
  • API 密钥已设置且不是占位符
  • 测试连接成功

故障排查

连接超时

如果你遇到连接超时：

  1. 检查你的网络连接
  2. 验证端点 URL 是否正确
  3. 提高配置中的超时时间值
身份验证错误

如果你遇到 401/403 错误：

  1. 验证你的 API 密钥是否正确
  2. 检查该密钥是否具有所需的权限
  3. 确保该密钥尚未过期

评论

支持 Markdown