Loxo MCP Server

](https://mseep.ai/app/tbensonwest-loxo-mcp-server)

Loxo MCP 服务器

📚 文档： https://tbensonwest.github.io/loxo-mcp-server/

一个模型上下文协议（MCP）服务器，使Claude可以直接访问Loxo招聘平台。1.7.0版本提供了34个工具，涵盖了招聘人员的完整工作流程：搜索和研究候选人、管理工作流程、跟踪活动和沟通、与公司合作以及维护候选人记录。工具描述引导克劳德展示招聘人员的录取记录和丰富的英特尔活动历史，这样它就可以回答“我们把这个候选人的东西放在哪里了？”而无需你去挖掘。

安装

选项0：通过Smithery安装（最简单）

通过以下方式为Claude Desktop自动安装 史密瑟里:

npx -y @smithery/cli install loxo-mcp-server --client claude

](https://smithery.ai/server/loxo-mcp-server)

选项1：本地安装

# Clone the repository
git clone [repository-url]
cd loxo-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

选项2：Docker安装

# Clone the repository
git clone [repository-url]
cd loxo-mcp-server

# Build the Docker image
docker build -t loxo-mcp-server .

# Or use Docker Compose
docker-compose build

配置

复制提供的 .env.example 文件到 .env 并填写您的值：

cp .env.example .env

然后更新 .env 使用您的配置文件：

LOXO_API_KEY=your_api_key
LOXO_DOMAIN=app.loxo.co
LOXO_AGENCY_SLUG=your_agency_slug

所需的环境变量：

• LOXO_API_KEY：您的Loxo API密钥
• LOXO_AGENCY_SLUG：你的机构在Loxo的蛞蝓
• LOXO_DOMAIN：（可选）默认为“app.loxo.co”
• LOXO_DEFAULT_OWNER_ID：（可选）默认Loxo用户ID设置为 owned_by_id 通过此服务器创建或更新的候选人。通过查找您的ID loxo_list_users.如果未设置，则归零；每次通话被覆盖 owned_by_id arg。
• LOXO_DEFAULT_OWNER_EMAIL：（可选）交易所有权的默认电子邮件。被...使用 loxo_create_deal 当否 owner_email arg已提供。通过以下方式查找电子邮件 loxo_list_users.

Docker配置

使用Docker时，环境变量会自动从您的 .env 文件通过Docker Compose，或者可以直接传递：

使用Docker Compose （推荐）：

# Ensure your .env file is configured
docker-compose up

直接使用Docker:

docker run -i \
  -e LOXO_API_KEY=your_api_key \
  -e LOXO_AGENCY_SLUG=your_agency_slug \
  -e LOXO_DOMAIN=app.loxo.co \
  loxo-mcp-server

备注：The -i 标志是必需的，因为MCP服务器通过stdin/stdout进行通信。

用法

运行服务器

本地:

npm start

使用Docker Compose:

docker-compose up

直接使用Docker:

docker run -i \
  -e LOXO_API_KEY=your_api_key \
  -e LOXO_AGENCY_SLUG=your_agency_slug \
  loxo-mcp-server

与Claude Desktop集成

添加到您的Claude Desktop配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

本地安装:

{
  "mcpServers": {
    "loxo": {
      "command": "node",
      "args": ["/path/to/loxo-mcp-server/build/index.js"],
      "env": {
        "LOXO_API_KEY": "your_api_key",
        "LOXO_AGENCY_SLUG": "your_agency_slug",
        "LOXO_DOMAIN": "app.loxo.co"
      }
    }
  }
}

Docker安装:

{
  "mcpServers": {
    "loxo": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "LOXO_API_KEY=your_api_key",
        "-e", "LOXO_AGENCY_SLUG=your_agency_slug",
        "-e", "LOXO_DOMAIN=app.loxo.co",
        "loxo-mcp-server"
      ]
    }
  }
}

工作流示例

准备客户简报包

“为诺斯维尔的角色准备一份简报。”

1. loxo_search_jobs --找到诺斯维尔的工作并获取其身份证
2. loxo_get_job_pipeline --获取所有候选人及其当前阶段
3. loxo_get_candidate_brief （每个候选人）--在一个电话中提取录取通知书、联系方式和最近丰富的英特尔活动
4. 将当前阶段、动机、薪酬预期和最近的接触点汇编成一份结构化的简报文件

______________________________________________________________________

管道状态更新

“给我所有在职候选人的最新状态。”

1. loxo_get_job_pipeline --检索该角色及其舞台上的所有候选人
2. loxo_get_candidate_brief （每位候选人）——获取录取笔记和最近的活动，总结每次对话的进展情况
3. 提供简洁的状态摘要：阶段、上次联系、下一步

______________________________________________________________________

为候选人匹配新角色

“我们数据库中的谁适合这个新的首席财务官角色？”

1. loxo_search_candidates --使用Lucene查询按标题、技能、行业和标签搜索
2. loxo_get_candidate_brief （适用于入围候选人）-审查录取记录和活动历史，以评估真正的适合度和当前可用性
3. 根据招聘人员笔记和最近的谈话中的支持证据，找出最佳匹配

可用工具

寻找和研究候选人

• loxo_search_candidates --使用Lucene查询搜索候选数据库。按当前职位、过去的雇主、技能、标签、位置或任何组合进行筛选。每页返回100个结果，包括技能集和标签，因此您可以在不进行额外调用的情况下进行筛选。跟进 loxo_get_candidate_brief 对于入围的候选人。
• loxo_get_candidate --完整的候选人资料，包括简历、当前职位、技能、标签、薪酬以及招聘人员的录取和电话记录（在 description 现场）。这 description 该领域通常是候选人最丰富的智力来源：动机、个人情况、薪酬期望和角色偏好。
• loxo_get_candidate_brief --当你需要完整的候选人背景时，可以使用该工具。在一次通话中返回个人资料（包括录取通知书）、所有联系方式以及最近丰富的情报活动（电话、电子邮件、笔记、面试——过滤掉了管道噪音）。在起草外联、准备简报包或评估候选人角色契合度之前，请使用此功能。支持分页 scroll_id 重新挖掘旧的活动。
• loxo_get_person_emails --候选人的所有电子邮件地址，带有类型标签（工作、个人等）。
• loxo_get_person_phones --候选人档案中的所有电话号码，带有类型标签（手机、工作、家庭等）。
• loxo_list_person_job_profiles --候选人的完整工作历史列表：所有角色、公司和日期。
• loxo_get_person_job_profile_detail --候选人工作经历中特定角色的详细信息。使用后 loxo_list_person_job_profiles 当你需要某个特定职位的完整描述时。
• loxo_list_person_education_profiles --候选人的完整教育历史：所有学位、学校和日期。
• loxo_get_person_education_profile_detail --关于特定教育项目的详细信息。使用后 loxo_list_person_education_profiles 当你需要特定资格的完整细节时。

管理管道和工作

• loxo_search_jobs --使用Lucene查询（标题、位置或任何组合）搜索打开的角色。使用基于页面的分页。
• loxo_get_job --完整的工作细节，包括描述、要求、薪酬、状态和招聘团队。
• loxo_get_job_pipeline --所有候选人目前都处于工作的管道阶段（来源、筛选、面试、录用、安置）。返回候选ID和阶段；跟进 loxo_get_candidate_brief 了解每个人的完整背景。
• loxo_add_to_pipeline --将候选人添加到工作的管道中。将它们置于第一阶段，并使其在 loxo_get_job_pipeline.

交易和BD管道

• loxo_list_deal_workflows --列出所有带有ID和名称的交易工作流（管道）。用于在搜索或创建交易之前发现存在哪些管道。
• loxo_get_deal_workflow --获取交易工作流程的详细信息，包括管道阶段。用于查找有效 pipeline_stage_id 值为 loxo_create_deal.
• loxo_search_deals --搜索处理可选的Lucene查询和所有者电子邮件过滤器。使用基于光标的分页 scroll_id.
• loxo_get_deal --完整的交易细节，包括姓名、金额、截止日期、管道阶段和关联公司/人员/职位。
• loxo_create_deal --在管道中创建新交易。需要名称、金额、关闭日期、工作流ID和管道阶段ID。所有者电子邮件回退到 LOXO_DEFAULT_OWNER_EMAIL.
• loxo_log_deal_activity --记录交易活动。使用 loxo_get_activity_types 根据协议 workflow_id 以查找特定于交易的活动类型ID。

跟踪活动和沟通

• loxo_get_candidate_activities --候选人的完整活动时间表：所有电话、电子邮件、会议、笔记、管道移动和自动化事件，最近的优先。可选过滤条件 activity_type_ids （使用 loxo_get_activity_types 以发现ID）。要获得更清晰、更专注于英特尔的视图，请使用 loxo_get_candidate_brief 相反。
• loxo_log_activity --记录针对候选人的已完成活动（电话、电子邮件、会议、面试）。使用 loxo_get_activity_types 首先找到正确的活动类型ID。
• loxo_schedule_activity --为候选人创建未来的活动（电话、会议、面试）。使用 loxo_get_activity_types 首先找到正确的活动类型ID。
• loxo_get_todays_tasks --今天（或您指定的日期范围）的所有计划项目。可选择按用户过滤。
• loxo_get_activity_types --列出所有活动类型及其ID。可选通过a workflow_id 获取特定交易的活动类型，而不是候选类型。在记录或安排活动之前调用此命令。

公司和参考数据

• loxo_create_company --创建新公司（客户/目标客户）。目前只接受 name.
• loxo_search_companies --使用Lucene查询搜索公司数据库。使用基于光标的分页 scroll_id.
• loxo_get_company_details --完整的公司简介，包括描述、联系人、关系和状态。
• loxo_list_users --Loxo代理机构的所有用户（招聘人员、协调员等），包括姓名和电子邮件。用于查找 user_id 用于筛选任务或检查记录所有权的值。
• loxo_list_skillsets --所有技能集和行业经验选项及其ID。用于查找有效 skillset_ids 和 sector_ids 调用前的值 loxo_update_candidate.
• loxo_list_source_types -所有候选源类型（LinkedIn、API、Referral等）及其ID。用于查找有效 source_type_id 价值观。
• loxo_list_person_types --所有人员类型类别（在职候选人、潜在候选人等）及其ID。用于查找有效 person_type_id 价值观。

候选人管理

• loxo_create_candidate --使用姓名、联系信息和当前角色创建新的候选人记录。创建后，使用 loxo_update_candidate 设置标签、技能集、人员类型和源类型。
• loxo_update_candidate --更新现有候选人的详细信息：个人资料字段、标签、技能集、行业、人员类型和来源类型。使用 loxo_list_skillsets 和 loxo_list_person_types 首先查找有效的ID。
• loxo_upload_resume --将简历或履历文件上传到候选人的个人资料中。接受base64编码的文件内容。该文件出现在他们的Loxo记录的简历部分。

建筑

建立在 模型上下文协议SDK，通过stdio进行通信，与Claude Desktop和Claude.ai无缝集成。

• v1.7.0 --34个工具；工具描述指导克劳德展示招聘人员的入职笔记(description 现场）和英特尔丰富的活动（电话、电子邮件、笔记、采访），同时过滤掉管道自动化噪音
• 所有API调用都转到 https://{LOXO_DOMAIN}/api/{LOXO_AGENCY_SLUG}/... 使用承载令牌身份验证
• POST/PATCH请求主体使用 application/x-www-form-urlencoded 用括号表示（例如。 person[name])
• 根据官方Loxo OpenAPI规范验证所有端点

分页

根据端点的不同，使用两种分页样式：

• 基于光标(scroll_id) --供候选人、公司、交易、日程项目和活动使用。通过 scroll_id 从一个响应到下一个响应，浏览页面。
• 基于页面(page / per_page) --用于工作。通过 page=1, page=2等等。

活动与事件系统

所有活动跟踪（电话、电子邮件、会议、笔记、管道移动）都要经过 person_events API

• 预定活动 --使用 loxo_schedule_activity 有未来 created_at 日期时间
• 已完成的活动 --使用 loxo_log_activity；自动应用当前时间戳
• 活动可以链接到个人、工作和/或公司
• loxo_get_candidate_brief 仅将活动过滤为富intel类型（不包括流水线自动化事件和其他低信号条目）

发展

本地开发

# Run in development mode with watch mode
npm run dev

# Build the project
npm run build

# Start the server
npm start

Docker开发

# Rebuild after code changes
docker-compose build

# Run with live logs
docker-compose up

# Run in detached mode
docker-compose up -d

# View logs
docker-compose logs -f

# Stop the container
docker-compose down