Gusto MCP 2026 Complete

🚀 不想自己主持？ 加入我们完全托管解决方案的候补名单→ 零设置。零维护。只需连接和自动化。

______________________________________________________________________

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

💡 这解锁了什么

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

🎯 Gusto特定力量动作

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

与其登录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:克劳德桌面（推荐）

1. 克隆和构建：

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

1. 获取您的Gusto OAuth令牌：

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

1. 配置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"
         }
       }
     }
   }

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

方案2：地方发展

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

🔐 认证

Gusto使用 OAuth2 用于身份验证：

1. 首选 Gusto开发者门户
2. 创建新 合作伙伴申请
3. 配置OAuth重定向URI
4. 使用OAuth流获取 访问令牌
5. 集 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文件
• Gusto开发者门户
• OAuth 2.0指南
• MCP协议规范
• Claude桌面设置

🤝 贡献

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

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

📄 许可证

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

🙏 学分

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

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

______________________________________________________________________

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