@orbitlogistics/mcp-plain

用于 Plain 客户支持平台的 MCP 服务器。通过 Model Context Protocol 提供用于管理线程、帮助中心文章等的工具。

设置

使用 Claude Code

添加到项目的 .claude/settings.json：

{
  "mcpServers": {
    "plain": {
      "command": "npx",
      "args": ["-y", "@orbitlogistics/mcp-plain@latest"],
      "env": {
        "PLAIN_API_KEY": "${PLAIN_API_KEY}"
      }
    }
  }
}

然后在 shell 环境中设置 PLAIN_API_KEY（例如 .zshrc、.envrc 或密钥管理器）。

使用其他 MCP 客户端

直接运行服务器：

PLAIN_API_KEY=plainApiKey_xxx npx @orbitlogistics/mcp-plain@latest

Related MCP server: plane-mcp-server

工具

注意： 此服务器并未覆盖完整的 Plain API——仅包含我们实际使用的端点。如果您需要其他方法，欢迎提交 PR！

线程

• list_threads - 使用筛选条件列出线程（状态、优先级、标签、客户、租户）

• get_thread - 按 ID 获取完整线程详情（包含时间线）

• get_thread_by_ref - 按引用编号获取线程（例如 T-510）

• get_thread_fields - 获取线程的自定义字段值

• create_thread - 创建新线程（如有需要，会自动按电子邮件创建客户）

• reply_to_thread - 通过原始渠道发送回复

• mark_thread_as_done - 将线程标记为已解决

• upsert_thread_field - 设置/更新自定义字段值

• add_internal_note - 发布内部备注（客户不可见）

• add_labels - 向线程添加类别标签

• get_label_types - 列出可用的标签类型

线程链接

• link_threads - 将线程链接到另一个 Plain 线程、Linear 问题、Jira 问题或通用来源

• get_thread_links - 列出线程上的链接

• unlink_thread - 按链接 ID 移除链接

get_thread 和 get_thread_by_ref 还会在 links 数组中返回线程的前 25 个链接。

附件

• get_attachment_download_url - 获取临时下载 URL

• get_attachment_content - 获取附件内容（文本或 base64）

帮助中心

• list_help_centers - 列出所有帮助中心

• get_help_center - 获取帮助中心结构（分组和文章）

• list_help_center_articles - 列出包含完整内容的文章

• get_help_center_article - 按 ID 获取文章

• get_help_center_article_by_slug - 按 URL 别名获取文章

• upsert_help_center_article - 创建或更新文章（始终保存为草稿）

• create_help_center_article_group - 创建文章分组

• delete_help_center_article_group - 删除空文章分组

开发

pnpm install
pnpm test
pnpm build

许可证

MIT