MCP Server Check

mcp服务器检查

⚠️ 早期访问测试版 --此MCP服务器目前处于测试阶段，可供部分合作伙伴使用。API、工具和行为可能会更改，恕不另行通知。请与您的检查联系人分享反馈。

服务条款 -通过使用此MCP服务器访问Check API，您同意 MCP使用条款，这是您与Check现有协议的补充。

一 主控程序 包装的服务器 检查工资API，为管理公司、员工、承包商、工资单、税务配置、嵌入式组件等提供263个工具。

快速启动

git clone https://github.com/check-technologies/mcp-server-check.git
cd mcp-server-check
uv sync
CHECK_API_KEY=your-key uv run mcp-server-check

配置

沙盒vs生产

默认情况下，服务器连接到 检查沙盒 (https://sandbox.checkhq.com)，这对测试和开发是安全的。沙箱支持模拟端点（例如。 simulate_start_processing, simulate_complete_funding)这让你在没有实际资金流动的情况下，通过处理州提前发放工资。

要指向生产，请设置：

CHECK_API_BASE_URL=https://api.checkhq.com

服务器配置

服务器支持细粒度的工具过滤，可通过环境变量（用于stdio）或HTTP标头（用于SSE/可流式传输的HTTP）进行配置。以下是 .

筛选优先级： exclude_tools > read_only > tools > toolsets排除总是赢；如果 tools 它作为一个独立于工具集的列表。

工具集

共有17个工具集，每个API模块一个： bank_accounts, companies, compensation, components, contractor_payments, contractors, documents, employees, external_payrolls, forms, payments, payroll_items, payrolls, platform, tax, webhooks, workplaces.

仅启用特定的工具集：

CHECK_TOOLSETS=companies,employees CHECK_API_KEY=your-key uv run mcp-server-check

个人工具

只允许按名称列出特定工具：

CHECK_TOOLS=list_companies,get_company,list_employees CHECK_API_KEY=your-key uv run mcp-server-check

不包括工具

隐藏特定工具，同时保留其他所有内容：

CHECK_EXCLUDE_TOOLS=create_company,delete_company CHECK_API_KEY=your-key uv run mcp-server-check

只读模式

集 CHECK_READ_ONLY=1 仅使用只读工具（列表、获取、下载、预览等）运行服务器。所有创建、更新、删除和其他变异工具都被排除在外。当您希望在没有修改风险的情况下探索Check数据时，这很有用。

CHECK_READ_ONLY=1 CHECK_API_KEY=your-key uv run mcp-server-check

HTTP标头（远程传输）

跑步时 CHECK_TRANSPORT=sse 或 CHECK_TRANSPORT=streamable-http，客户端可以通过HTTP标头传递配置：

X-MCP-Toolsets: companies,employees
X-MCP-Readonly: true
X-MCP-Exclude-Tools: create_company,delete_company

当标头提供任何筛选器设置时，基于标头的配置优先于环境变量。

动态工具模式（默认）

默认情况下，服务器以动态模式运行(CHECK_TOOL_MODE=dynamic)，公开3个元工具，而不是所有单独的工具。这避免了将每个工具模式预先发送到LLM，节省了大量的上下文窗口空间。

• search_tools(query, toolset?, limit?) --通过同义词匹配的关键字搜索工具。返回具有完整参数模式的匹配工具。
• list_toolsets() --列出所有可用的工具集，并附上说明和示例工具。
• run_tool(tool_name, arguments?) --使用参数字典按名称执行工具。

LLM工作流变为：浏览工具集或搜索相关工具→ 查看他们的参数模式→ call run_tool 用正确的论据。全部筛选(CHECK_TOOLSETS, CHECK_READ_ONLY等等）在搜索层和执行层都应用。

集 CHECK_TOOL_MODE=all 单独公开所有工具（传统模式）：

CHECK_TOOL_MODE=all CHECK_API_KEY=your-key uv run mcp-server-check

使用Claude Desktop

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "check": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/mcp-server-check", "mcp-server-check"],
      "env": {
        "CHECK_API_KEY": "your-api-key"
      }
    }
  }
}

使用Claude代码

claude mcp add check -- uv run --directory /path/to/mcp-server-check mcp-server-check

然后设置 CHECK_API_KEY 在运行Claude Code之前，先在shell中设置环境变量。

可用工具

263个工具，分为17个类别。所有列表工具支持 limit 和 cursor 基于光标的分页参数--传递 cursor 从上一个响应中获取值以获取下一页。

公司（26种工具）

员工（17工具）

承包商（10个工具）

工作场所（4个工具）

工资单（15个工具）

工资单项目（8个工具）

承包商付款（6种工具）

外部工资单（8个工具）

补偿（32工具）

工资表、福利、税后扣除、公司福利、收入率、收入代码和净工资分割。

银行账户（6个工具）

文档（19个工具）

表格（4个工具）

付款（6种工具）

税（31工具）

税务参数、选择、申报、免税状态、免税、报表和套餐。

Webhooks（7个工具）

平台（29个工具）

通知、通信、使用、集成、会计、公司组、地址、设置和要求。

嵌入式组件（35个工具）

通过以下方式生成可嵌入的UI组件URL POST /{entity_type}/{entity_id}/components/{component_type}.所有工具都接受 entity_id 可选 data 配置。

公司组成部分（25）： create_company_previous_provider_access_component, create_company_accounting_integration_component, create_company_authorization_documents_component, create_company_business_details_component, create_company_checklist_component, create_company_company_reports_component, create_company_connect_bank_account_component, create_company_details_component, create_company_early_enrollment_component, create_company_employee_setup_component, create_company_filing_authorization_component, create_company_filing_preview_component, create_company_full_service_setup_submission_component, create_company_integrations_component, create_company_integrations_authorize_component, create_company_pay_history_component, create_company_payment_setup_component, create_company_progress_tracker_component, create_company_run_payroll_component, create_company_signatory_agreements_component, create_company_tax_documents_component, create_company_tax_setup_component, create_company_team_setup_component, create_company_terms_of_service_component, create_company_verification_documents_component

员工构成（9）： create_employee_benefits_component, create_employee_payment_setup_component, create_employee_paystubs_component, create_employee_post_tax_deductions_component, create_employee_profile_component, create_employee_ssn_setup_component, create_employee_tax_documents_component, create_employee_tax_setup_component, create_employee_withholdings_setup_component

承包商组成部分（1）： create_contractor_tax_documents_component

发展

git clone https://github.com/check-technologies/mcp-server-check.git
cd mcp-server-check
uv sync --group dev
uv run pytest  # 311 tests