Zendesk Oauth MCP

MCPAI代理

提供方 BagToad

AI代理 未标注 OAuth 授权 社区 / 第三方

一个通过浏览器会话cookie为AI代理提供Zendesk工单只读访问的MCP服务器,适用于API令牌不可用的情况。

一句话选型结论

按资料字段整理

Zendesk Oauth MCP 属于AI代理类 MCP 服务器,传输方式未标注,OAuth 授权,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式未标注 鉴权OAuth 授权 部署方式未标注
GitHub 星标 3 仓库热度,无公开仓库时显示未标注
工具数 4 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量4暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

Zendesk集成Go本地部署只读访问AI代理客服系统自动化工具

安装与配置

未标注 OAuth 授权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 4 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 4 个工具,职责相对集中,接入后不容易误操作。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Zendesk Oauth MCP当前 4 未标注 未标注 无 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方BagToad上游标注的维护方 BagToad
分类AI代理本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

8.0 KB
来自项目仓库与上游目录的原文,未做删改

Zendesk OAuth MCP服务器

提供AI代理的MCP服务器 只读 使用浏览器会话cookie访问Zendesk票证-在API令牌不可用的情况下使用。允许您的代理搜索工单、阅读工单详细信息和查看对话历史记录。此服务器无法创建、更新或删除任何Zendesk数据。

设置

1.下载二进制文件

从以下网址下载适用于您平台的最新版本 发布页面.```bash

macOS (Apple Silicon)

gh release download --repo BagToad/zendesk-oauth-mcp -p 'darwin_arm64'

macOS (Intel)

gh release download --repo BagToad/zendesk-oauth-mcp -p 'darwin_amd64'

Linux (x86_64)

gh release download --repo BagToad/zendesk-oauth-mcp -p 'linux_amd64'
``````bash
tar -xzf zendesk-oauth-mcp_*.tar.gz
chmod +x zendesk-oauth-mcp

Move to a directory on your PATH

mv zendesk-oauth-mcp ~/.local/bin/


> **注意(macOS):** 如果macOS阻止二进制文件,请删除隔离属性:
>
>```bash
> xattr -dr com.apple.quarantine ~/.local/bin/zendesk-oauth-mcp
> ```

或者从源代码构建:```bash
gh repo clone BagToad/zendesk-oauth-mcp
cd zendesk-oauth-mcp
go build -o zendesk-oauth-mcp .

2.确保 ~/.local/bin 正在您的路径上

如果 ~/.local/bin 还没有在你的 PATH,将其添加到您的shell配置文件中:

bash/zsh:```bash
PATH="$HOME/.local/bin:$PATH"


然后重新启动shell或运行 `source ~/.bashrc` / `source ~/.zshrc`.

`fish`:```fish
fish_add_path ~/.local/bin

3.添加到您的MCP客户端

将服务器添加到MCP客户端配置中。唯一需要的设置是 ZENDESK_SUBDOMAIN:

GitHub Copilot命令行界面 -添加到 ~/.copilot/mcp-config.json:```json
{
"mcpServers": {
"zendesk": {
"command": "zendesk-oauth-mcp",
"args": [],
"env": {
"ZENDESK_SUBDOMAIN": "your-subdomain"
}
}
}
}


服务器将自动从浏览器中提取您的Zendesk会话cookie(请参阅 认证).您还可以通过添加来手动提供cookie `"ZENDESK_COOKIE": "your-cookie-string"` 到 `env` 块。

> 如果二进制文件不在您的 `PATH`,请使用二进制文件的完整路径(例如。 `/Users/you/.local/bin/zendesk-oauth-mcp`).

### 4.安装Zendesk技能

复制包含的 技能档案 转到您的个人技能目录,这样Copilot就知道如何在所有项目中使用Zendesk工具:```bash
mkdir -p ~/.copilot/skills/zendesk-mcp
cp .github/skills/zendesk-mcp/SKILL.md ~/.copilot/skills/zendesk-mcp/

> 如果您没有此仓库的本地克隆,可以直接下载该文件:
>
>bash > mkdir -p ~/.copilot/skills/zendesk-mcp > gh api repos/BagToad/zendesk-oauth-mcp/contents/.github/skills/zendesk-mcp/SKILL.md \ > --jq '.content' | base64 -d > ~/.copilot/skills/zendesk-mcp/SKILL.md >

5.安装Zendesk Investigator代理

复制包含的 代理文件 到您的个人代理目录,以便Copilot可以执行端到端的票证调查:```bash
mkdir -p ~/.copilot/agents
cp .github/agents/zendesk-investigator.agent.md ~/.copilot/agents/


> 如果您没有此仓库的本地克隆,可以直接下载该文件:
>
>```bash
> mkdir -p ~/.copilot/agents
> gh api repos/BagToad/zendesk-oauth-mcp/contents/.github/agents/zendesk-investigator.agent.md \
>   --jq '.content' | base64 -d > ~/.copilot/agents/zendesk-investigator.agent.md
> ```

### 6.重新启动MCP客户端

重新启动MCP客户端(例如重新启动Copilot CLI)以获取新的服务器、技能和代理。您现在应该可以访问 `search_tickets`, `get_ticket`, `get_ticket_comments`,以及 `list_tickets` 工具。

### 7.测试连接

通过让Copilot查询您的Zendesk实例来验证您的设置是否正常工作:```
show me all open tickets assigned to $USER

如果所有配置都正确,您应该会看到您的未结工单列表。如果您遇到身份验证错误,请仔细检查cookie和子域值。

更新

要更新到最新版本,请下载新的二进制文件并替换现有的二进制文件:```bash

macOS (Apple Silicon)

gh release download --repo BagToad/zendesk-oauth-mcp -p 'darwin_arm64' --clobber

macOS (Intel)

gh release download --repo BagToad/zendesk-oauth-mcp -p 'darwin_amd64' --clobber

Linux (x86_64)

gh release download --repo BagToad/zendesk-oauth-mcp -p 'linux_amd64' --clobber
``````bash
tar -xzf zendesk-oauth-mcp_*.tar.gz
chmod +x zendesk-oauth-mcp
mv -f zendesk-oauth-mcp ~/.local/bin/


> **注意(macOS):** 如果macOS阻止更新的二进制文件,请删除隔离属性:
>
>```bash
> xattr -dr com.apple.quarantine ~/.local/bin/zendesk-oauth-mcp
> ```

然后重新启动MCP客户端以获取新版本。

## 认证

此服务器使用浏览器的会话cookie向Zendesk进行身份验证。这意味着它具有与您登录的Zendesk帐户相同的权限,不需要管理员设置。

### 自动Cookie提取(推荐)

当 `ZENDESK_COOKIE` 如果未设置,服务器将在启动时使用以下命令自动从浏览器的cookie数据库中提取cookie 古怪的支持的浏览器:

|浏览器|macOS |Linux|
|---|---|---|
|禅|✅ | ✅ |
|火狐浏览器|✅ | ✅ |
|Safari |✅ | - |
|Chrome |✅ | ✅ |
|边缘|✅ | ✅ |

服务器按照上面列出的顺序搜索浏览器。一旦找到有效的Zendesk Cookie,它就会停止搜索。这意味着 **首先检查Zen和Firefox** 并且不需要任何密码提示。

如果cookie在会话中期过期(401错误),服务器将自动从浏览器中重新提取并重试请求。

> **macOS上的Chrome浏览器:** Chrome使用macOS钥匙链加密Cookie。服务器首次读取Chrome Cookie时,macOS将显示密码提示以允许Keychain访问。您可以在钥匙串访问中授予“始终允许”,但每当重建二进制文件时,此选项都会重置。为了完全避免出现提示,请确保您在非Chromium浏览器(Zen、Firefox或Safari)中登录到Zendesk。

### 环境变量

|变量|必填|描述|
|---|---|---|
| `ZENDESK_SUBDOMAIN` |是|您的Zendesk子域(例如。 `mycompany` 为了 `mycompany.zendesk.com`) |
| `ZENDESK_COOKIE` |否|已满 `Cookie` 标头值。如果省略,服务器会自动从您的浏览器中提取Cookie。 |

### 手动Cookie设置

如果自动提取不适用于您的设置,您可以手动提供cookie:

1. 在浏览器中登录您的Zendesk实例
1. 打开 **开发者工具** → **网络** 标签
1. 点击任何请求 `zendesk.com`
1. 找到 `Cookie` 标题在 **请求头**
1. 复制整个cookie字符串并将其设置为 `ZENDESK_COOKIE` 在MCP配置中

> **⚠️ 安全说明:** 会话cookie授予您对Zendesk帐户的完全访问权限。将其视为密码,不要将其提交到源代码管理或在日志中共享。

## 工具和用法

此服务器提供四种MCP工具: `search_tickets`, `get_ticket`, `get_ticket_comments`,以及 `list_tickets`.

有关详细的工具文档、参数、搜索语法和代理使用提示,请参阅 技能档案.

此回购还包括 Zendesk票务调查员代理 它可以执行端到端的票证调查-收集上下文、搜索相关票证、跟踪根本原因和生成结构化摘要。如果你有 `gh-slack` 安装了扩展后,代理还可以在Slack中搜索与工单相关的内部讨论。

### 常见错误

|错误|原因|修复|
|---|---|---|
| `spawn zendesk-oauth-mcp ENOENT` |在您的计算机上找不到二进制文件 `PATH` |确保 `~/.local/bin` 在你的 `PATH` (参见步骤2),并且二进制文件位于那里。 |
| `spawn zendesk-oauth-mcp EACCES` |二进制文件缺少执行权限|运行 `chmod +x ~/.local/bin/zendesk-oauth-mcp` |
| `401 Unauthorized` |Cookie已过期|服务器会通过从浏览器中重新提取来自动重试。如果这种情况持续存在,请在浏览器中登录Zendesk以刷新会话。 |
| `403 Forbidden` |权限不足|确保经过身份验证的用户具有代理访问权限|
| `404 Not Found` |票ID无效|验证票ID是否存在|
| `429 Too Many Requests` |速率受限|等待并重试;降低请求频率|

## 发展```bash
go build -o zendesk-oauth-mcp .   # Build the binary
go run .                          # Run without building

许可证

麻省理工学院

常见问题

5 问
答案由本站依据条目字段整理,不引用上游原文
Zendesk Oauth MCP 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Zendesk Oauth MCP 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Zendesk Oauth MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Zendesk Oauth MCP 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

Zendesk Oauth MCP 能提供哪些能力?

资料显示约 4 个工具;能力标签包括 Go、只读访问、AI代理。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。