AI导哈

招聘管理系统连接器

一个连接Claude与Ashby招聘系统的MCP服务器，支持通过自然语言对话浏览职位、管理候选人、跟踪申请进度等功能。

  • by PlenishAI
  • Python
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 PlenishAI/mcp-ashby

使用说明

阿什比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密钥。确保它至少有：

  • candidatesRead
  • jobsRead
  • candidatesWrite （如果要创建候选人、添加注释或移动应用程序）

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)

许可证

麻省理工学院

相关 MCP