阿什比MCP服务器
A. 模型上下文协议（MCP） 将Claude连接到您的服务器 阿什比 ATS。浏览工作、管理候选人、通过招聘渠道跟踪申请等——所有这些都是通过自然对话完成的。
先决条件
- Python 3.10+
- 紫外线 --一个快速的Python包管理器
- Ashby API密钥 和
candidatesRead,jobsRead，以及candidatesWrite权限
- 生成一个https://app.ashbyhq.com/admin/api/keys
设置
1.安装uv
如果你还没有 uv 安装：
# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# macOS via Homebrew
brew install uv安装后，找到到的绝对路径 uvx 命令（您需要在配置中使用此命令）：
which uvx这将返回类似的内容 /Users/yourname/.local/bin/uvx.把这条路放在手边。
2.获取您的Ashby API密钥
首选https://app.ashbyhq.com/admin/api/keys并创建新的API密钥。确保它至少有：
candidatesReadjobsReadcandidatesWrite（如果要创建候选人、添加注释或移动应用程序）
3.配置克劳德桌面
打开您的Claude Desktop配置文件：
- macOS：
~/Library/Application Support/Claude/claude_desktop_config.json - 窗户：
%APPDATA%\Claude\claude_desktop_config.json
将以下内容添加到 mcpServers 部分，将占位符替换为实际值：
{
"mcpServers": {
"ashby": {
"command": "/absolute/path/to/uvx",
"args": [
"--from", "git+https://github.com/PlenishAI/mcp-ashby.git",
"ashby"
],
"env": {
"ASHBY_API_KEY": "your-ashby-api-key"
}
}
}
}重要提示： 替换/absolute/path/to/uvx输出来自which uvx（例如。/Users/yourname/.local/bin/uvx).Claude Desktop不继承shell的PATH，因此需要完整路径。
4.重新启动克劳德桌面
退出并重新打开Claude Desktop。阿什比服务器应自动连接。你可以问克劳德“列出我在阿什比的空缺职位”之类的问题来验证
替代方案：本地克隆设置
如果 git+ URL方法不起作用（例如私有仓库或网络限制），您可以在本地克隆仓库：
git clone https://github.com/PlenishAi/mcp-ashby.git ~/projects/mcp-ashby然后使用 uv （不是 uvx)在您的配置中，指向本地目录：
{
"mcpServers": {
"ashby": {
"command": "/absolute/path/to/uv",
"args": [
"--directory", "/absolute/path/to/mcp-ashby",
"run", "ashby"
],
"env": {
"ASHBY_API_KEY": "your-ashby-api-key"
}
}
}
}注： 使用本地克隆时，运行which uv要获取路径，命令是uv，不uvx.
要更新，只需 git pull 从repo目录。
可用工具
工作
| 工具 | 说明 |
|---|---|
job_list | 列出所有具有可选状态筛选器（草稿、打开、已关闭、已存档）的作业 |
job_info | 按ID获取单个作业的详细信息 |
job_search | 按职位搜索职位 |
候选人
| 工具 | 说明 |
|---|---|
candidate_list | 用光标分页列出所有候选人 |
candidate_search | 通过电子邮件和/或姓名搜索候选人 |
candidate_info | 按ID获取候选人的完整详细信息 |
candidate_create | 创建新候选人 |
candidate_create_note | 向候选人添加HTML格式的注释 |
candidate_list_notes | 列出候选人的所有备注 |
candidate_add_tag | 为候选人添加标签 |
candidate_tag_list | 列出所有可用的候选标签 |
应用程序
| 工具 | 说明 |
|---|---|
application_list | 列出具有可选jobId、状态和日期筛选器的应用程序 |
application_info | 按ID获取应用程序的完整详细信息 |
application_create | 创建一个将候选人链接到工作的应用程序 |
application_change_stage | 将申请转移到不同的面试阶段 |
访谈和管道
| 工具 | 说明 |
|---|---|
interview_stage_list | 列出给定面试计划的面试阶段 |
interview_plan_list | 列出所有面试计划 |
interview_list | 列出所有带有光标分页的访谈 |
interview_info | 通过ID获取单次面试的详细信息 |
参考数据
| 工具 | 说明 |
|---|---|
department_list | 列出所有部门 |
user_list | 列出所有用户（团队成员） |
source_list | 列出所有候选来源 |
archive_reason_list | 列出所有存档原因 |
location_list | 列出所有地点 |
故障排除
启动时“没有这样的文件或目录”
Claude Desktop找不到 uvx请确保您正在使用 完全绝对路径 从 which uvx 在你的配置中，不仅仅是 "uvx".
“在注册表中找不到包”
如果您看到PyPI解析错误，请确保 --from 论证使用 git+https:// URL，而不是包名。
“模块没有属性'run_async'”
您正在针对较新的MCP SDK运行较旧版本的服务器代码。获取此仓库的最新版本。
API错误（401/403）
您的Ashby API密钥丢失或没有所需的权限。在以下位置进行验证https://app.ashbyhq.com/admin/api/keys.
API 参考
此服务器与 Ashby REST API:
- 基本URL:
https://api.ashbyhq.com - 认证： 基本身份验证（API密钥作为用户名，空密码）
- 方法： 所有端点都是带有JSON主体的POST
- 分页： 基于光标(
moreDataAvailable+nextCursor)
许可证
麻省理工学院