PingCode MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PINGCODE_BASE_URL | Yes | PingCode base URL, e.g. https://your-domain.pingcode.com | |
| PINGCODE_READONLY | No | Set to 'true' to enable read-only mode | false |
| PINGCODE_CLIENT_ID | No | Client ID for OAuth2 client credentials | |
| PINGCODE_AUTH_SCHEME | No | Auth scheme, default Bearer | |
| PINGCODE_BUG_TYPE_ID | No | Bug type ID | |
| PINGCODE_ACCESS_TOKEN | No | Direct API access token | |
| PINGCODE_API_BASE_URL | No | API base URL, default https://open.pingcode.com | |
| PINGCODE_CLIENT_SECRET | No | Client secret for OAuth2 client credentials | |
| PINGCODE_AUTH_TOKEN_PATH | No | Path to store user token | |
| PINGCODE_OAUTH_REDIRECT_URI | No | OAuth redirect URI | |
| PINGCODE_PROJECT_IDENTIFIER | Yes | Project key identifier | |
| PINGCODE_OAUTH_AUTHORIZE_URL | No | OAuth authorize URL | |
| PINGCODE_REQUIREMENT_TYPE_ID | No | Requirement type ID | |
| PINGCODE_DEFAULT_ASSIGNEE_NAME | Yes | Default assignee name for 'my items' |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| pingcode_get_project_schemaC | 获取 PingCode 项目、工作项类型、状态、优先级、成员等配置,用于确认 Bug/需求映射。 |
| pingcode_get_current_teamA | 获取当前 PingCode 企业/团队信息(只读)。 |
| pingcode_get_current_userA | 获取当前用户(只读)。应用身份(client_credentials)下 PingCode 无登录用户,自动降级返回配置的默认负责人。 |
| pingcode_auth_loginA | 用户态浏览器授权登录。不传 code:返回授权 URL 与引导,请去浏览器打开并登录授权,再从回调地址复制 code 回来;传 code:用授权码换取并保存用户令牌(0600 本地文件),返回当前用户。不读取浏览器 cookie/storage,不要把网页登录 token 贴进聊天。 |
| pingcode_auth_statusA | 查询当前鉴权状态:模式(user / env-token / application)、是否已授权、相对过期秒数、当前用户。不返回任何 token。 |
| pingcode_auth_logoutA | 清除本地保存的用户态 token(删除 0600 token 文件)。 |
| pingcode_get_team_membersB | 查询企业成员列表(只读),支持关键字与部门 ID(≤20)过滤、分页。 |
| pingcode_check_setupA | 检查 PingCode MCP 配置是否完整,并返回需要在聊天框向使用者询问的信息、每个信息去哪里找、以及 env 配置模板。 |
| pingcode_list_bugsA | 拉取 PingCode 缺陷列表,默认项目为 PROJ。 |
| pingcode_list_requirementsC | 拉取 PingCode 需求清单,默认项目为 PROJ。 |
| pingcode_list_my_bugsA | 拉取当前使用者负责的 PingCode 缺陷。默认负责人读取 PINGCODE_DEFAULT_ASSIGNEE_NAME。 |
| pingcode_list_my_requirementsA | 拉取当前使用者负责的 PingCode 需求。默认负责人读取 PINGCODE_DEFAULT_ASSIGNEE_NAME。 |
| pingcode_import_bugsC | 按截图表头从 .xlsx/.csv 导入缺陷。默认 dryRun=true。 |
| pingcode_import_requirementsC | 按截图表头从 .xlsx/.csv 导入需求清单。默认 dryRun=true。 |
| pingcode_update_bug_statusB | 按编号或工作项 ID 修改单个缺陷状态。 |
| pingcode_mark_bugs_fixedA | 修完 bug 后批量把缺陷从 新提交 更新为 已修复。默认 dryRun=true,并校验当前状态仍为 新提交。 |
| pingcode_add_work_item_commentA | 按编号或工作项 ID 给 PingCode 缺陷/需求追加评论。默认 dryRun=true。 |
| pingcode_list_work_item_commentsB | 按编号或工作项 ID 获取 PingCode 缺陷/需求评论列表。 |
| pingcode_update_requirement_statusB | 按编号或工作项 ID 修改单个需求状态。 |
| pingcode_get_work_itemB | 按编号或工作项 ID 获取单个缺陷/需求的完整详情(描述、时间、父项、属性、图片),可选附带评论。 |
| pingcode_search_work_itemsA | 跨缺陷与需求统一搜索:支持关键字、状态/优先级/负责人(按名称)与更新时间范围;并支持 raw 过滤——项目/类型/父项/负责人/状态/优先级/标签/迭代/看板/入口/泳道/阶段/版本/创建人 ID 列表(≤20,与对应 name 合并去重)、participantId 单值、createdBetween/startBetween/endBetween 秒级时间戳、includeDeleted/includeArchived 布尔。返回按 id 去重的合并结果与各类型总数。 |
| pingcode_plan_status_changeA | 只读:返回工作项状态变更计划(当前状态、目标状态、可用状态、保护条件是否满足)。PingCode 不校验工作流,目标是否合法以实际 PATCH 为准。 |
| pingcode_update_work_item_fieldsA | 按编号或工作项 ID 编辑标题、描述、优先级、负责人、父项、自定义属性。默认 dryRun=true,仅 PATCH 变化字段。 |
| pingcode_bulk_update_work_itemsA | 用原生批量端点为多个工作项编号批量改优先级/负责人/状态。默认 dryRun=true,支持 expectedCurrentStatusName 跳过不匹配项;每个变更字段各发一次 bulk PATCH。 |
| pingcode_create_work_itemA | 创建单个缺陷/需求,必填标题,可选描述、优先级、负责人、父项、初始状态、属性。默认 dryRun=true,仅返回创建计划。 |
| pingcode_triage_work_itemA | 一站式处理工作项:合并负责人/优先级/状态变更为一次 PATCH,并可选追加评论。默认 dryRun=true。 |
| pingcode_get_my_workA | 聚合当前负责人的缺陷与需求并按状态分组(每组带计数、按工作项 ID 去重)。支持 assigneeName 覆盖默认负责人、状态与更新时间过滤。只读。 |
| pingcode_link_work_itemsB | 在两个工作项间建立关系(阻塞/被阻塞/重复/关联/依赖等)。relationType 支持系统枚举或自定义关系类型名/ID。默认 dryRun=true,仅返回计划。 |
| pingcode_unlink_work_itemsB | 按 relationId 删除工作项的某条关系;relationId 来自 pingcode_list_work_item_relations。默认 dryRun=true。 |
| pingcode_list_work_item_relationsA | 按编号或工作项 ID 列出工作项的全部关系(可按 relationType 过滤),返回每条关系的 id 与目标工作项。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/frontendRicky/pingcode-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server