使用说明

🚀 不想自己主持？ 加入我们完全托管解决方案的候补名单→

零设置。零维护。只需连接和自动化。

💼 Gusto MCP服务器——人力资源与薪酬智能

💡 这解锁了什么

此MCP服务器使AI可以直接访问您的Gusto人力资源和工资数据。 停止手动导出电子表格或搜索仪表板。用简单的英语问克劳德问题，并立即得到答案。

🎯 Gusto特定力量动作

用例	它的作用	使用的工具
员工人数报告	获取当前员工名单，包括工资、部门、角色	`list_employees`, `get_employee`
工资对账	提取某个日期范围内的已处理工资单，验证金额	`list_payrolls`, `get_payroll`
承包商审计	列出所有1099名承包商和年初至今付款	`list_contractors`
福利登记检查	查看谁注册了健康、401k等。	`list_benefits`, `list_employees`
公司信息导出	获取所有公司详细信息、地点、税号	`get_company`

🔗 真正的力量：自然语言人力资源查询

与其登录Gusto并四处点击：

“显示过去6个月雇用的所有员工”
“2024年第四季度我们的总工资是多少？”
“列出今年付款超过1万美元的所有承包商”
“谁参加了我们的健康保险计划？”
“获取公司详细信息，包括所有地点”

📦 里面有什么

7个以人力资源为中心的API工具 涵盖Gusto的核心人员运营：

员工： list_employees, get_employee --员工目录、工资、部门
工资单： list_payrolls, get_payroll --工资、毛额/净额、税款
承包商： list_contractors --1099名承包商和付款
公司： get_company --组织详细信息、位置、设置
优点： list_benefits --健康保险、401k、其他福利

所有这些都具有OAuth2承载令牌身份验证、正确的错误处理和TypeScript类型。

🚀 快速开始

选项1:克劳德桌面（推荐）

克隆和构建：

git clone https://github.com/BusyBee3333/Gusto-MCP-2026-Complete.git
cd gusto-mcp-2026-complete
npm install
npm run build

获取您的Gusto OAuth令牌：
- 登录 Gusto开发者门户
- 创建一个新应用
- 完成OAuth流程以获得 访问令牌
- 注： Gusto使用OAuth2，因此您需要为生产使用实现刷新流

配置Claude桌面：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "gusto": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/gusto-mcp-2026-complete/dist/index.js"],
      "env": {
        "GUSTO_ACCESS_TOKEN": "your-oauth-access-token"
      }
    }
  }
}

重新启动克劳德桌面 --您将在MCP部分看到7个Gusto工具

方案2：地方发展

cp .env.example .env
# Edit .env with your Gusto OAuth token
npm run dev

🔐 认证

Gusto使用 OAuth2 用于身份验证：

首选 Gusto开发者门户
创建新 合作伙伴申请
配置OAuth重定向URI
使用OAuth流获取 访问令牌
集 GUSTO_ACCESS_TOKEN 在您的环境中

所需范围：

employees:read
payrolls:read
contractors:read
company:read
benefits:read

API文件： https://docs.gusto.com/

⚠️ 令牌到期： 访问令牌在一段时间后过期。对于生产，使用Gusto的OAuth刷新流实现令牌刷新。

🎯 示例提示

一旦连接到克劳德：

员工管理：

“列出工程部门的所有员工”
“显示员工ID abc123的详细信息”
“我们的新员工是谁？”

工资分析：

“从2025年1月起取消所有已处理的工资单”
“显示ID xyz789的工资单详细信息”
“我们每次的平均总工资是多少？”

承包商管理：

“列出所有承包商”
“哪些承包商的年初至今付款超过5万美元？”

公司和福利：

“获取我们公司的信息”
“我们提供什么好处？”
“有多少员工参加了401k计划？”

🛠️ 发展

先决条件

Node.js 18+
npm或纱线
具有API访问权限的Gusto帐户（需要合作伙伴应用程序设置）

本地设置

git clone https://github.com/BusyBee3333/Gusto-MCP-2026-Complete.git
cd gusto-mcp-2026-complete
npm install
cp .env.example .env
# Edit .env with your OAuth token
npm run build
npm start

项目结构

gusto-mcp-2026-complete/
├── src/
│   └── index.ts          # Main MCP server + Gusto API client
├── dist/                 # Compiled JavaScript (npm run build)
├── package.json
├── tsconfig.json
└── .env.example

测试

npm test                  # Run all tests
npm run test:watch        # Watch mode
npm run test:coverage     # Coverage report

🐛 故障排除

“Gusto API错误：401未经授权”

您的访问令牌无效或已过期
通过OAuth流生成新令牌
验证您是否已设置 GUSTO_ACCESS_TOKEN 正确地

“Gusto API错误：403禁止”

您的OAuth应用程序没有所需的作用域
在Gusto开发者门户中检查应用程序的权限

“工具未出现在Claude中”

更新后重新启动Claude Desktop claude_desktop_config.json
验证路径是否 绝对的 （没有 ~ 或相对路径）
检查一下 npm run build 成功完成
寻找 dist/index.js 文件

“需要company_id”

大多数Gusto API调用都需要 company_id 参数
通过以下方式获取您的公司ID get_company() 工具优先
或者在Gusto仪表板URL中找到它

📖 资源

🤝 贡献

欢迎投稿！要添加新的Gusto API端点，请执行以下操作：

分叉回购
将工具定义添加到 src/index.ts （工具阵列）
在中实现处理程序 handleTool() 功能
用新功能更新README
提交PR

📄 许可证

MIT许可证-请参阅许可证详见

🙏 学分

由...建造 MCPEngage --商业软件的人工智能基础设施。

想要更多的MCP服务器吗？ 查看我们的完整目录涵盖30多个业务平台（吐司、日历、条纹、QuickBooks等）。

问题？ 打开一个问题或加入我们不和谐社区.