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' |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| 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