Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
PINGCODE_BASE_URLYesPingCode base URL, e.g. https://your-domain.pingcode.com
PINGCODE_READONLYNoSet to 'true' to enable read-only modefalse
PINGCODE_CLIENT_IDNoClient ID for OAuth2 client credentials
PINGCODE_AUTH_SCHEMENoAuth scheme, default Bearer
PINGCODE_BUG_TYPE_IDNoBug type ID
PINGCODE_ACCESS_TOKENNoDirect API access token
PINGCODE_API_BASE_URLNoAPI base URL, default https://open.pingcode.com
PINGCODE_CLIENT_SECRETNoClient secret for OAuth2 client credentials
PINGCODE_AUTH_TOKEN_PATHNoPath to store user token
PINGCODE_OAUTH_REDIRECT_URINoOAuth redirect URI
PINGCODE_PROJECT_IDENTIFIERYesProject key identifier
PINGCODE_OAUTH_AUTHORIZE_URLNoOAuth authorize URL
PINGCODE_REQUIREMENT_TYPE_IDNoRequirement type ID
PINGCODE_DEFAULT_ASSIGNEE_NAMEYesDefault assignee name for 'my items'

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

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