help-scout-mcp-server

概述

一个 MCP 服务器，为 AI 助手提供直接访问 Help Scout 收件箱、对话、客户、组织和线程的权限。它使支持团队能够通过关键词、日期范围、状态或标签搜索工单，按姓名或电子邮件查找客户，探索组织，提取线程历史记录，并监控收件箱活动。该服务器实现 OAuth2 客户端凭据流程进行安全认证，并包含可选的 PII 遮蔽功能以满足合规要求。

试试问 AI

装完之后，这里有 6 个你可以让 AI 做的事：

• searchConversations

  List recent tickets from Help Scout

  试试:Show me active tickets from this week试试:List recent customer inquiries
• comprehensiveConversationSearch

  Find conversations by keyword or complex criteria

  试试:Find conversations about billing errors试试:Search for discussions regarding product features
• structuredConversationFilter

  Look up a specific conversation by ticket number

  试试:Show me ticket #42839试试:Find conversation with ID 12345
• advancedConversationSearch

  Apply complex filters to conversation searches

  试试:All @acme.com conversations tagged urgent试试:Find conversations from last month with status 'pending'
• listCustomers

  Browse customers by name or criteria

  试试:Show customers named Jane试试:List customers with premium support
• searchCustomersByEmail

  Find a customer by exact email address

  试试:Find customer jane@acme.com试试:Look up support@example.com
• getCustomer

  Retrieve detailed information about a specific customer

  试试:Open customer 12345试试:Get details for customer profile 67890
• getCustomerContacts

  Pull customer contact channels and details

  试试:Show contact details for customer 12345试试:List all contact methods for customer profile 67890
• listOrganizations

  Browse organizations in Help Scout

  试试:Show the busiest organizations试试:List all organizations
• getOrganization

  Retrieve detailed information about a specific organization

  试试:Open organization 456试试:Get details for company profile 789
• getOrganizationMembers

  List customers within a specific organization

  试试:Who belongs to organization 456?试试:Show all members of company 789
• getConversationSummary

  Get a quick overview of a conversation

  试试:Summarize this conversation试试:Give me a brief overview of ticket 12345

可对比工具

安装

{
  "mcpServers": {
    "helpscout": {
      "command": "npx",
      "args": ["help-scout-mcp-server"],
      "env": {
        "HELPSCOUT_APP_ID": "您的应用 ID",
        "HELPSCOUT_APP_SECRET": "您的应用密钥"
      }
    }
  }
}

npm install -g help-scout-mcp-server

FAQ

此服务器使用什么认证方法？

Help Scout 仅使用 OAuth2 客户端凭据流程。不支持个人访问令牌。

如何从 Help Scout 获取 API 凭据？

转到 Help Scout > My Apps > Create Private App，至少选择对收件箱、对话、客户和组织的读取权限，然后复制您的应用 ID 和应用密钥。

我可以将服务器限制到特定收件箱吗？

是的，设置 HELPSCOUT_DEFAULT_INBOX_ID 环境变量可将搜索限制到特定收件箱。

help-scout-mcp-server 对比