Finance Toolkit
500+ transparent financial methods calculated from raw statements, not third-party endpoints.
パソコンでもクラウドでも
MCP FactorialHR
概要
作者による説明（英語の原文）
Full CRUD MCP server for FactorialHR: employees, teams, time off, projects, ATS, payroll.
PopNx MCPの3つの柱
この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。
- 利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
- 私たちの基本チェックi1項目中1項目に合格公開情報からチェック。コードはまだスキャンしていません
- 利用状況iとても新しい↓ 330/週 · ★ –
できること
このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。
- 接続方法: パソコンで動く
- トランスポート: stdio
- カテゴリ: 会計・財務・税務
- 入力が必要なもの：FACTORIAL_API_KEY
インストール
使っているAIアプリを選んで、設定をコピーしてください。
インストールの前に
- 基本チェック：1項目中1項目に合格
- あなたのパソコンで、あなたのユーザーと同じ権限（ファイル、ネットワーク、アプリ）で動きます。
- 自分で入力するもの：
FACTORIAL_API_KEY,FACTORIAL_API_VERSION,FACTORIAL_TIMEOUT_MS,FACTORIAL_MAX_RETRIES,DEBUG
「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。
必要なもの
- npmNode.jsのインストール（npxコマンドに必要）
どのアプリを使っていますか？
上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。
Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます
{
"mcpServers": {
"factorial": {
"command": "npx",
"args": [
"-y",
"@t4dhg/mcp-factorial"
],
"env": {
"FACTORIAL_API_KEY": "your-value",
"FACTORIAL_API_VERSION": "your-value",
"FACTORIAL_TIMEOUT_MS": "your-value",
"FACTORIAL_MAX_RETRIES": "your-value",
"DEBUG": "your-value"
}
}
}
}ターミナルでこれを実行します
claude mcp add factorial --env FACTORIAL_API_KEY=your-value --env FACTORIAL_API_VERSION=your-value --env FACTORIAL_TIMEOUT_MS=your-value --env FACTORIAL_MAX_RETRIES=your-value --env DEBUG=your-value -- npx -y @t4dhg/mcp-factorial動かす前に、空欄の値を入力してください。
または、設定を自分でコピーする
プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます
{
"mcpServers": {
"factorial": {
"command": "npx",
"args": [
"-y",
"@t4dhg/mcp-factorial"
],
"env": {
"FACTORIAL_API_KEY": "your-value",
"FACTORIAL_API_VERSION": "your-value",
"FACTORIAL_TIMEOUT_MS": "your-value",
"FACTORIAL_MAX_RETRIES": "your-value",
"DEBUG": "your-value"
}
}
}
}ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。
または、設定を自分でコピーする
プロジェクトの .vscode/mcp.json に貼り付けます
{
"servers": {
"factorial": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@t4dhg/mcp-factorial"
],
"env": {
"FACTORIAL_API_KEY": "your-value",
"FACTORIAL_API_VERSION": "your-value",
"FACTORIAL_TIMEOUT_MS": "your-value",
"FACTORIAL_MAX_RETRIES": "your-value",
"DEBUG": "your-value"
}
}
}
}ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。
これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。
選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。
自分で入力する値
- API key from FactorialHR (Settings > API Keys)
FACTORIAL_API_VERSIONenvAPI version (default: 2026-07-01)FACTORIAL_TIMEOUT_MSenvRequest timeout in milliseconds (default: 30000)FACTORIAL_MAX_RETRIESenvMaximum retry attempts (default: 3)DEBUGenvEnable debug logging (default: false)
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
できること
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
基本チェックi
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月8日にチェック
- ✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント t4dhg で確認済みです
- … 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
- … 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
- – 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
- – 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
- … 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
会計・財務・税務のほかのサーバーとの比較i
- このカテゴリのほかの2933件のうち0%よりスターが多い
- このカテゴリのほかの2933件のうち87%より最近レジストリに公開
- 基本チェックの結果が、このカテゴリのほかの2933件のうち100%と同じかそれ以上
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
よくある質問
MCP FactorialHRは安全ですか？
当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
どんなキーやコードが必要ですか？
入力が必要なもの：FACTORIAL_API_KEY
パソコンで動きますか、それともクラウドですか？
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません（サーバー自体がオンラインサービスを呼び出す場合を除きます）。
今もメンテナンスされていますか？
GitHubリポジトリの最終更新は–、最新バージョン（12.0.0）がレジストリに届いたのは4 日前です。
どのアプリで使えますか？
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。
代わりに使えるものは？
同じカテゴリには：Finance Toolkit, SolidInvoice, Korea Tax Calculator
代わりの候補
同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。
カードの見方：↓ 週あたりのダウンロードi★ GitHubスターi3つの柱：レビュー · チェック · 利用状況i更新＝最新バージョンをレジストリに公開した日i
SolidInvoice
Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.
クラウドで動く✓ solidinvoice.co
Korea Tax Calculator
Korean tax calculation and tax-audit judgment MCP: 96 tools with statutory citations.
パソコンで動く
作者のREADME
READMEを開く
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
MCP FactorialHR
The definitive Model Context Protocol server for [FactorialHR](https://factorialhr.com)
A comprehensive Model Context Protocol (MCP) server that provides AI assistants like Claude with full access to FactorialHR. Manage employees, teams, time off, projects, training, recruiting, and more - all with built-in safety guardrails.
Why This MCP Server?
- Context-Optimized: 14 hierarchical tools (117 operations) with 88% less context usage than individual tools
- Full CRUD Operations: Create, read, update, and delete across all major entities
- Safety Guardrails: High-risk operations require explicit confirmation
- Audit Logging: All write operations are logged with timestamps and context for debugging
- Enterprise Ready: Built for companies who need AI integration with proper controls
Features
Hierarchical Tool Discovery (v8.0.0+)
The MCP server uses a hierarchical tool structure for optimal context usage. Instead of 124 individual tools, you get 14 category-based tools with an action parameter.
| Tool | Description | Actions |
|---|---|---|
factorial_discover | Discover available categories | - |
factorial_employees | Employee management | list, get, search, create, update, terminate |
factorial_teams | Team management | list, get, create, update, delete |
factorial_locations | Location management | list, get, create, update, delete |
factorial_contracts | Contract/salary data | list, get_with_employee, by_job_role, by_job_level |
factorial_time_off | Leave management | 10 actions |
factorial_attendance | Shifts and registro horario | 14 actions incl. clock_in, audit, log_range |
factorial_documents | Document management | 8 actions (downloads require OAuth2 - see below) |
factorial_job_catalog | Job roles/levels | list_roles, get_role, list_levels |
factorial_projects | Project management | 16 actions for projects, tasks, workers, time |
factorial_training | Training management | 12 actions for trainings, sessions, enrollments |
factorial_work_areas | Work area management | list, get, create, update, archive, unarchive |
factorial_ats | Applicant tracking | 17 actions for recruiting |
factorial_payroll | Payroll data (read-only) | 6 actions |
Example Usage:
// List all employeesfactorial_employees({ action: 'list', page: 1, limit: 50 });
// Get a specific employee factorial_employees({ action: 'get', id: 123 });
// Search employees factorial_employees({ action: 'search', query: 'john' });
// Create a leave request factorial_time_off({ action: 'create', employee_id: 123, leave_type_id: 1, start_on: '2026-02-01', finish_on: '2026-02-05', });
// Discover available actions for a category factorial_discover({ category: 'employees' });
124 Operations Across 14 Categories
| Category | Operations |
|---|---|
| Employees | list, get, search, create, update, terminate |
| Teams | list, get, create, update, delete |
| Locations | list, get, create, update, delete |
| Time Off | list_leaves, get_leave, list_types, get_type, list_allowances, create, update, cancel, approve, reject |
| Attendance | list, get, create, update, delete, clock_in, clock_out, status, gaps, audit, log_range, log_days, list_edit_requests, create_edit_request |
| Projects | 16 operations for projects, tasks, workers, time records |
| Training | 12 operations for trainings, sessions, enrollments |
| Work Areas | list, get, create, update, archive, unarchive |
| ATS | 17 operations for job postings, candidates, applications, hiring stages |
| Payroll | list/get supplements, tax identifiers, family situations (read-only) |
| Documents | 8 operations for folders, documents, and downloads (⚠️ downloads require OAuth2) |
| Job Catalog | list_roles, get_role, list_levels (read-only) |
| Contracts | list, get_with_employee, by_job_role, by_job_level (read-only) |
Attendance and Registro Horario
Factorial asks employees to record their working hours day by day. factorial_attendance lets Claude do that, for one day or for a whole month, and for any employee the API key can see.
Times are HH:MM in the company's local time, exactly as Factorial shows them; Factorial applies them in the company zone and the server never converts between zones. Records written by this server carry source: "api", so they are distinguishable from live clocks in Factorial's own activity log.
A write's declared working time (date, clock_in, clock_out) is independent of its entry metadata: Factorial stamps created_at, updated_at and in_source/out_source with when and how the record was entered, and those cannot be set or changed through the API. Every create, update, clock_in, clock_out, and every bulk preview and result, states the declared working time and says this once.
| Action | What it does |
|---|---|
status | Whether the employee is clocked in and since when. Always prints the configured identity. |
clock_in, clock_out | Live clocking at the current time, or, given date and time (HH:MM company local), a declared moment for someone who forgot to clock. A declared moment in the future is refused before any request is sent. A declared clock_out is refused if nothing is open, or if the moment precedes the open shift's start. |
| gaps | Workdays in a date range where the contract expects more hours than were tracked. Weekends, bank holidays and full-day leave are excluded.
冒頭だけを表示しています。続きはリポジトリで読めます