World Monitor
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.
Unofficial MCP server for Money Forward Cloud Kintai Plus (AKASHI): punches, records, man-hours
Lists are ordered by a usage score (out of 100) built from these parts
| Popularity | 20/80 | GitHub stars or weekly downloads: the larger counts 60, the smaller 20 |
|---|---|---|
| Freshness | 12/12 | Full marks for a release or code change within 30 days |
| Still answering | 0/8 | The cloud endpoint answered at the last check |
| Usage score | 32/100 |
Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: 23 (Used only on the Trending tab)
Pick the AI app you use, then copy the settings.
Let your AI install it with one sentence
Please install Kintai Plus (unofficial). Follow https://mcp.popnx.com/i/atzzcokek-kintai-plus-mcp.md, show me the commands and wait for my OK before running them.Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads
Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 14, 2026
First: which AI do you use?
Pick your app and the steps appear below.
Works with Claude, with some setup first
You need a Kintai Plus (unofficial) key (create it on the maker’s site) · Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Kintai Plus (unofficial) for Claude on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "kintai-plus": { "command": "npx", "args": [ "-y", "kintai-plus-mcp" ], "env": { "KINTAI_PLUS_TOKEN": "your-value", "KINTAI_PLUS_PERSIST_ENV_TOKEN": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For KINTAI_PLUS_TOKEN, KINTAI_PLUS_PERSIST_ENV_TOKEN, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Kintai Plus (unofficial) tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
SettingsDeveloperEdit Config
{
"mcpServers": {
"kintai-plus": {
"command": "npx",
"args": [
"-y",
"kintai-plus-mcp"
],
"env": {
"KINTAI_PLUS_TOKEN": "your-value",
"KINTAI_PLUS_PERSIST_ENV_TOKEN": "your-value"
}
}
}
}Paste the key only into the app’s field, never into a chat or to anyone
Use Kintai Plus (unofficial) and tell me what you can do for me, then show me one thing✓ If Claude says it is using Kintai Plus (unofficial) or shows a Kintai Plus (unofficial) tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
KINTAI_PLUS_COMPANY_ID Login company ID (ログイン企業ID), used with KINTAI_PLUS_TOKENKINTAI_PLUS_HOST API host (the domain of the URL after you sign in) · default atnd.ak4.jpKINTAI_PLUS_READ_ONLY Expose read-only tools only · default falseKINTAI_PLUS_CONFIRM Write confirmation: always, destructive (deletes only; the default when unset), or never. Overrides the level saved at login.KINTAI_PLUS_CONFIRM_WRITES Legacy boolean. true means always, false means never. Ignored when KINTAI_PLUS_CONFIRM is set.Descriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
ChatGPT cannot connect Kintai Plus (unofficial) yet
Kintai Plus (unofficial) runs on your computer, but ChatGPT can only connect servers that run on the web
A · Use an app that can connect Kintai Plus (unofficial)
B · Others in Other that work with ChatGPT
Picked from the most used in the same category, only ones that connect by address with no key
Works with Claude Code, with some setup first
You need a Kintai Plus (unofficial) key (create it on the maker’s site) · Install Node.js on your computer first (one time)
Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Kintai Plus (unofficial) for Claude Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user kintai-plus --env KINTAI_PLUS_TOKEN=your-value --env KINTAI_PLUS_PERSIST_ENV_TOKEN=your-value -- npx -y kintai-plus-mcp 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For KINTAI_PLUS_TOKEN, KINTAI_PLUS_PERSIST_ENV_TOKEN, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Kintai Plus (unofficial) tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
Mac: press Command+Space and type Terminal · Windows: open PowerShell
claude mcp add --scope user kintai-plus --env KINTAI_PLUS_TOKEN=your-value --env KINTAI_PLUS_PERSIST_ENV_TOKEN=your-value -- npx -y kintai-plus-mcpReplace “your-value” with your key before pressing Enter
Paste the key only into the app’s field, never into a chat or to anyone
You should see Kintai Plus (unofficial) listed as connected
Use Kintai Plus (unofficial) and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using Kintai Plus (unofficial) or shows a Kintai Plus (unofficial) tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
KINTAI_PLUS_COMPANY_ID Login company ID (ログイン企業ID), used with KINTAI_PLUS_TOKENKINTAI_PLUS_HOST API host (the domain of the URL after you sign in) · default atnd.ak4.jpKINTAI_PLUS_READ_ONLY Expose read-only tools only · default falseKINTAI_PLUS_CONFIRM Write confirmation: always, destructive (deletes only; the default when unset), or never. Overrides the level saved at login.KINTAI_PLUS_CONFIRM_WRITES Legacy boolean. true means always, false means never. Ignored when KINTAI_PLUS_CONFIRM is set.Descriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor, with some setup first
You need a Kintai Plus (unofficial) key (create it on the maker’s site) · Install Node.js on your computer first (one time)
Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Kintai Plus (unofficial) for Cursor on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "kintai-plus": { "command": "npx", "args": [ "-y", "kintai-plus-mcp" ], "env": { "KINTAI_PLUS_TOKEN": "your-value", "KINTAI_PLUS_PERSIST_ENV_TOKEN": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For KINTAI_PLUS_TOKEN, KINTAI_PLUS_PERSIST_ENV_TOKEN, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Kintai Plus (unofficial) tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
In the Kintai Plus (unofficial) settings, KINTAI_PLUS_TOKEN, KINTAI_PLUS_PERSIST_ENV_TOKEN is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use Kintai Plus (unofficial) and tell me what you can do for me, then show me one thing✓ If Cursor says it is using Kintai Plus (unofficial) or shows a Kintai Plus (unofficial) tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
KINTAI_PLUS_COMPANY_ID Login company ID (ログイン企業ID), used with KINTAI_PLUS_TOKENKINTAI_PLUS_HOST API host (the domain of the URL after you sign in) · default atnd.ak4.jpKINTAI_PLUS_READ_ONLY Expose read-only tools only · default falseKINTAI_PLUS_CONFIRM Write confirmation: always, destructive (deletes only; the default when unset), or never. Overrides the level saved at login.KINTAI_PLUS_CONFIRM_WRITES Legacy boolean. true means always, false means never. Ignored when KINTAI_PLUS_CONFIRM is set.Descriptions are as written by the maker.
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code, with some setup first
You need a Kintai Plus (unofficial) key (create it on the maker’s site) · Install Node.js on your computer first (one time)
Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Kintai Plus (unofficial) for VS Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "kintai-plus": { "type": "stdio", "command": "npx", "args": [ "-y", "kintai-plus-mcp" ], "env": { "KINTAI_PLUS_TOKEN": "your-value", "KINTAI_PLUS_PERSIST_ENV_TOKEN": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For KINTAI_PLUS_TOKEN, KINTAI_PLUS_PERSIST_ENV_TOKEN, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Kintai Plus (unofficial) tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
In the Kintai Plus (unofficial) settings, KINTAI_PLUS_TOKEN, KINTAI_PLUS_PERSIST_ENV_TOKEN is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use Kintai Plus (unofficial) and tell me what you can do for me, then show me one thing✓ If VS Code says it is using Kintai Plus (unofficial) or shows a Kintai Plus (unofficial) tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
KINTAI_PLUS_COMPANY_ID Login company ID (ログイン企業ID), used with KINTAI_PLUS_TOKENKINTAI_PLUS_HOST API host (the domain of the URL after you sign in) · default atnd.ak4.jpKINTAI_PLUS_READ_ONLY Expose read-only tools only · default falseKINTAI_PLUS_CONFIRM Write confirmation: always, destructive (deletes only; the default when unset), or never. Overrides the level saved at login.KINTAI_PLUS_CONFIRM_WRITES Legacy boolean. true means always, false means never. Ignored when KINTAI_PLUS_CONFIRM is set.Descriptions are as written by the maker.
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.
JSON settings are under “For developers” below
Claude Code
claude mcp add --scope user kintai-plus --env KINTAI_PLUS_TOKEN=your-value --env KINTAI_PLUS_PERSIST_ENV_TOKEN=your-value -- npx -y kintai-plus-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"kintai-plus": {
"command": "npx",
"args": [
"-y",
"kintai-plus-mcp"
],
"env": {
"KINTAI_PLUS_TOKEN": "your-value",
"KINTAI_PLUS_PERSIST_ENV_TOKEN": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"kintai-plus": {
"command": "npx",
"args": [
"-y",
"kintai-plus-mcp"
],
"env": {
"KINTAI_PLUS_TOKEN": "your-value",
"KINTAI_PLUS_PERSIST_ENV_TOKEN": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"kintai-plus": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"kintai-plus-mcp"
],
"env": {
"KINTAI_PLUS_TOKEN": "your-value",
"KINTAI_PLUS_PERSIST_ENV_TOKEN": "your-value"
}
}
}
}KINTAI_PLUS_TOKEN secret required envKINTAI_PLUS_PERSIST_ENV_TOKEN secret required envKINTAI_PLUS_COMPANY_ID envKINTAI_PLUS_HOST envKINTAI_PLUS_READ_ONLY envKINTAI_PLUS_CONFIRM envKINTAI_PLUS_CONFIRM_WRITES envDescriptions are as written by the maker.
These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Run on your computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Runs on your computer; the tool list appears in your AI app after you install it.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026
The registry name was verified with the GitHub account atzzCokeK, which owns the repo
Code last changed 11 days ago
Uses MIT
This one runs on your computer; there is no internet endpoint
Runs on your computer and uses local settings instead
Runs on your computer; we can only read tool lists from internet endpoints
No entries on OSV.dev for kintai-plus-mcp@1.1.0
Checks only this package version, not every dependency · checked Nov 15, 2026
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/servers/atzzcokek-kintai-plus-mcp)Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
No reviews yet
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
You need to fill in: KINTAI_PLUS_TOKEN, KINTAI_PLUS_PERSIST_ENV_TOKEN
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
The GitHub repo last changed 11 days ago, and the latest version (1.1.0) reached the registry 16 days ago.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.
In the same category: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu
Same category, other makers, commands already checked. Official ones first, then by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.
Manage monitors, status pages, incidents and maintenances in your openstatus workspace.
Validate oh-my-posh configurations and segment snippets against the official schema.
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.
| This one Kintai Plus (unofficial) | World Monitor | openstatus | Oh My Posh Validator | Strata | Jitsu | |
|---|---|---|---|---|---|---|
| Runs where | Installs on your computer | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install |
| Needs a key | Yes | No | No | No | No | No |
| Add with + in Claude | No | No | No | No | No | No |
| Basic checks | 3/3 | 4/4 | 4/4 | 4/4 | 1/4 | 4/4 |
| License | MIT | AGPL-3.0 | AGPL-3.0 | MIT | Apache-2.0 | MIT |
| Price | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry |
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
非公式 の MCP サーバーです。株式会社マネーフォワードとは関係がなく、同社による確認・保証は受けていません。
「マネーフォワード クラウド勤怠Plus」「AKASHI」などの名称・商標は、それぞれの権利者に帰属します。
マネーフォワード クラウド勤怠Plus(旧 AKASHI)の公開 API を、Claude などの AI アシスタントから使えるようにする Model Context Protocol サーバーです。
「出勤して」「今月の残業はどれくらい?」「昨日の工数を設計 2 時間・実装 5 時間で入れて」のように話しかけるだけで、打刻・勤務実績の確認・工数入力ができます。
公開 API の仕様(公式): マネーフォワード クラウド勤怠Plus 公開API 仕様
1.0 からは、ツール名・引数・プロンプト名を互換性の約束とします。これらを壊す変更は、メジャーバージョンを上げるときだけ行います。まだ未確認の API の点は docs/api-notes.md の「未確認事項」にあります。
0.1.x から 1.0 で、次の名前だけ変えます。旧名では呼べません。
| 0.1.x | 1.0 |
|---|---|
プロンプト monthly_review | end_of_month(end_of_day の月末版。close_out を案内する) |
ツール get_working_statuses | get_working_treatments(勤務処理のラベル。打刻の get_today_status とは別) |
| ツール | 内容 |
|---|---|
get_my_profile | 自分の従業員情報と権限 |
get_today_status | 今日の状況(未出勤/勤務中/休憩中/退勤済み)と、ここまでの勤務時間 |
close_out | 1 日または月の締め。打刻漏れ・法定の休憩不足・工数の過不足・残業の目安・アラートを、優先度つきの残件として 1 回で返す |
get_attendance_guide | 就業ルール・法定休憩・打刻種別の説明(いまの勤務データではない) |
punch 【書き込み】 | 打刻(出勤・退勤・直行・直帰・休憩入・休憩戻、テレワーク) |
get_stamps | 打刻履歴(長い期間は自動で分割) |
get_working_records | 勤務実績(労働区分・時刻・実働・休憩。31 日ごとに自動で分割)。任意の staffIds で管理下の従業員も取れる。省略時は本人 |
summarize_working_hours | 実働合計・出勤日数・休日出勤日数・法定時間外の目安(月ごとの内訳つき) |
get_alerts | アラート(打刻忘れ、遅刻、36協定 など) |
check_attendance_issues | 打刻漏れチェック(退勤・出勤・休憩戻の打刻忘れ、12 時間超の日、勤務間インターバル 11 時間未満、休日出勤)。勤務実績にその時刻がある日は打刻漏れにしない。休憩が不明な経過時間は、12 時間超を情報にとどめる |
list_projects / list_tasks / get_my_projects | プロジェクトとタスク |
get_manhours | 工数(プロジェクト名・タスク名つき) |
save_manhours 【書き込み】 / delete_manhours 【書き込み】 | 工数の登録・更新・削除 |
管理者(企業管理者・一般管理者)には、次のツールも表示されます。一般の従業員には表示されません。
| ツール | 内容 |
|---|---|
list_staff | 管理下の従業員の一覧(ID・氏名・社員番号・所属のみ) |
get_team_stamps | 管理下の従業員の 1 日分の打刻と状況。過去日の退勤なしは「退勤打刻なし」で、その日の終わりまでは数えない |
team_close_out | 管理下の 1 日または月の締め。勤務実績を主に、打刻漏れ・出勤の重複・法定休憩・11 時間のインターバル・残業の目安(36 時間と 45 時間)を 1 回で返す。問題が無い人は人数だけ。実績も打刻も無い人は別。アラートと工数未入力は見ない |
get_working_treatments | 勤務処理のラベル(欠勤・出張など)。打刻の get_today_status とは別 |
get_project_members | プロジェクトのメンバー |
find_overtime_risks | 残業リスク検出(今月の法定時間外の目安と月末の着地予測。既定のしきい値は 45 時間) |
対応しているクライアントでは、メニューから次のプロンプトを呼び出せます(使うツールが公開されているときだけ表示)。
| プロンプト | 内容 |
|---|---|
end_of_day | 退勤前チェック(close_out で今日の残件を見て、工数を埋めてから退勤を打刻) |
log_manhours | 工数を入力する(日付と、やったことを渡せる) |
end_of_month | 月末の締め(close_out で残件と残業の目安を 1 回で確認。0.1.x の monthly_review) |
team_status | 管理者向け: チームの今日の状況と残業リスク |
team_end_of_month | 管理者向け: チームの月末締め(team_close_out を 1 回) |
対応しているクライアントでは、次の URI をコンテキストとして読めます。中身はツールと同じです。リソースが無いクライアントは、右のツールを使ってください。
| URI | 同じ内容のツール |
|---|---|
kintai://today | get_today_status(今日の状態) |
kintai://close-out/month | close_out(scope=month、今月) |
kintai://guide | get_attendance_guide(就業ルール、法定休憩、打刻種別) |
管理者が行うこと(一度だけ): 従業員設定 > 対象の従業員の「変更」 > 利用機能設定 で、「公開API利用可否」を「利用する」にします。
本人が行うこと: マイページ > APIトークン で発行します。トークンの有効期限は 1 ヶ月と 1 日です。login で登録したトークンは、登録時と、期限が近づいたときに再発行します。
loginで登録するトークンは、このツール専用にしてください。再発行すると、それまで使っていたトークンは使えなくなります。環境変数で渡すだけの場合は、既定では再発行しません(下の「環境変数でトークンを渡す」)。
npx kintai-plus-mcp login
次を聞かれます。
atnd.ak4.jp です。atnd.ak4.jp(既定。https://atnd.ak4.jp/ でログインしている)atnd-awj.ak4.jp(https://atnd-awj.ak4.jp/ でログインしている)端末でない入力(パイプなど)では、接続先は矢印ではなくドメインかその URL を 1 行で渡します。空行は atnd.ak4.jp です。--host で指定したときは接続先を聞きません。確認レベルは聞きません(保存してある値はそのまま。変えるときは下の環境変数か、対話の login)。Ctrl+C で選択を中断します。
疎通を確認してから保存します。状態の確認と削除は次のとおりです。
npx kintai-plus-mcp status # 保存先・有効期限・権限(トークンは表示しません)
npx kintai-plus-mcp logout # 保存した認証情報を削除
Claude Desktop
claude_desktop_config.json に追加します。
{
"mcpServers": { "kintai-plus": { "command": "npx", "args": ["-y", "kintai-plus-mcp"] } } }
</details>
Claude Code
claude mcp add kintai-plus -- npx -y kintai-plus-mcp
Cursor
~/.cursor/mcp.json(またはプロジェクトの .cursor/mcp.json):
{
"mcpServers": { "kintai-plus": { "command": "npx", "args": ["-y", "kintai-plus-mcp"] } } }
</details>
VS Code(GitHub Copilot)
.vscode/mcp.json:
{
"servers": { "kintai-plus": { "type": "stdio", "command": "npx", "args": ["-y", "kintai-plus-mcp"] } } }
</details>
Codex CLI
~/.codex/config.toml:
[mcp_servers.kintai-plus]
command = "npx" args = ["-y", "kintai-plus-mcp"]
</details>
| 変数 | 既定 | 内容 |
|---|---|---|
KINTAI_PLUS_READ_ONLY | false | true で書き込みツール(打刻・工数)を出さない |
KINTAI_PLUS_CONFIRM | (下を参照) | 書き込み前の確認。always(毎回)/ destructive(削除だけ。未設定時の既定)/ never(確認しない)。設定してあると、login で保存した値より優先します |
KINTAI_PLUS_INCLUDE_LOCATION | false | true で打刻の位置情報・IP を返す |
KINTAI_PLUS_REFRESH_DAYS | 15 | 有効期限の残りがこの日数を切ったら再発行する(1〜30) |
KINTAI_PLUS_AUTO_REFRESH | true | false で自動の再発行を止める |
KINTAI_PLUS_PERSIST_ENV_TOKEN | false | true で、環境変数のトークンを保存し、期限が不明なら再発行する。環境変数の値は使えなくなることがある |
KINTAI_PLUS_CREDENTIAL_STORE | auto | 保存先: auto(キーチェーン → ファイル)/ keychain / file |
KINTAI_PLUS_CREDENTIALS_FILE | ~/.config/kintai-plus-mcp/credentials.json | ファイル保存のパス(指定するとファイル保存になる) |
KINTAI_PLUS_LOG_LEVEL | info | debug / info / warn / error / silent(ログは stderr のみ) |
KINTAI_PLUS_MIN_INTERVAL_MS | 300 | API リクエストの最小間隔(ミリ秒) |
既定は 打刻は確認なし、削除だけ確認 です。打刻と工数の保存はそのまま実行し、工数の削除だけ止めます。login で選んだ値は、認証情報とは別に保存します。
| 値 | 動き |
|---|---|
always | 打刻・工数の保存・削除の前に確認する |
destructive | 削除だけ確認する(既定) |
never | 確認しない |
確認が必要なとき:
confirm: true で呼び直すと実行します。KINTAI_PLUS_READ_ONLY=true のときは書き込みツール自体を出しません。打刻が今日の履歴と矛盾するときは、確認の前に拒否します(force: true はこれまでどおり)。
以前の KINTAI_PLUS_CONFIRM_WRITES(と、さらに古い CONFIRM_WRITES)は、KINTAI_PLUS_CONFIRM が無いときだけ読みます。true は always、false は never です。
login が使えないときは、環境変数だけで起動できます。既定では保存せず、再発行 API も呼びません。
KINTAI_PLUS_TOKEN=... KINTAI_PLUS_COMPANY_ID=... KINTAI_PLUS_HOST=atnd.ak4.jp npx kintai-plus-mcp
再発行 API は、渡したトークンを無効にして新しいトークンを返します。環境変数の値を自動で再発行すると、その値を共有している他のプロセスが突然使えなくなります。このサーバーは、明示しない限りそれをしません。
自動更新(期限が近づいたら再発行して保存)が必要なときは、このサーバー専用のトークンを npx kintai-plus-mcp login で登録してください。キーチェーンが使えない環境では、本人だけが読み書きできるファイル(パーミッション 600)に保存します。
環境変数のトークンを保存して再発行する動作は、KINTAI_PLUS_PERSIST_ENV_TOKEN=true を付けたときだけです。有効にすると、環境変数に書いたトークンは使えなくなることがあります。保存先にすでに認証情報があるときは、環境変数より保存先を優先します。
close_out)「退勤前に見て」「今月締められる?」は close_out が 1 回で答えます。個別の確認ツールを順に呼ぶ必要はありません。scope は day(既定・今日)か month(既定・今月)です。日付は日本時間です。
残件が無い日は、こう返します(抜粋。実際には overtime や disclaimer も付きます)。
{
"scope": "day", "ok": true, "readyToClose": true, "headline": "2026-10-27 は締められます。対応は不要です。", "counts": { "error": 0, "warning": 0, "info": 0 }, "items": [] }
昼休みを打刻し忘れて休憩が 3 分しかない日(実働 8 時間 57 分)は、最初の項目が次のようになります。過去の打刻は API で直せないので、案内は Web の修正申請です。
{
"ok": false, "headline": "先に 1 件対応してください。items を priority 順に処理してください。", "items": [ { "priority": 1, "severity": "error", "code": "short_break", "date": "2026-10-26", "title": "休憩が 3 分しかありません", "detail": "打刻上の休憩は 3 分、実働は 8:57。労働基準法: 労働時間が 6 時間を超えたら休憩 45 分以上、8 時間を超えたら 60 分以上(ちょうど 6 時間・8 時間は含まない)。必要 60 分、あと 57 分足りません。", "action": "この日はすでに終わっているので、今 punch しても休憩は増えません。この打刻は API では修正できません。勤怠Plus の Web 画面から修正申請(打刻修正)をしてください。punch は呼ばないでください(今の時刻で新しい打刻が増えるだけです)。" } ] }
今日がまだ休憩中なら、code は open_break で、次の操作は punch(type=break_end)です。修正申請ではありません。
force)調べた範囲です。「未確認」は未対応という意味ではありません。
| 機能 | Claude Code | Cursor | VS Code | ChatGPT | Gemini CLI |
|---|---|---|---|---|---|
| ツール注釈(読み取り / 破壊的 / 冪等 / 外部) | あり | 未確認 | あり | あり | 未確認 |
| 書き込み前の確認(Elicitation) | あり | あり | あり | 未確認 | 未確認 |
リソース(kintai://...) | あり | あり | あり | 未確認 | 一部 |
| structuredContent | 未確認 | 未確認 | 未確認 | あり | 未確認 |
注釈は全ツールに付いています。打刻は書き込みですが destructive ではありません(後から修正申請で直せます)。工数の削除は destructive です。成功したオブジェクトは、JSON のテキストと structuredContent の両方で返します。
logout は手元の認証情報を削除するだけです。トークン自体を無効にするには、マイページで操作してくださいpnpm install
pnpm test # Vitest(モックと架空のフィクスチャのみ) pnpm lint # Biome pnpm typecheck pnpm build # tsdown pnpm e2e # 実環境を叩く手動 E2E(読み取りのみ。手元でだけ実行)
設計の決定事項は docs/design.md、背景は docs/adr/ にあります。
Unofficial MCP server for the public API of "Money Forward Cloud Kintai Plus" (formerly AKASHI), a Japanese attendance management service. This project is not affiliated with, endorsed by, or sponsored by Money Forward, Inc. All trademarks belong to their respective owners.
close_out), view punch history, working records, alerts, and man-hours, and record man-hoursteam_close_out, 勤務処理 labels via get_working_treatments, project members) are shown only to admins. get_working_treatments is not today's punch status (get_today_status)npx kintai-plus-mcp. Register your token first with npx kintai-plus-mcp loginKINTAI_PLUS_TOKEN is not stored or reissued unless KINTAI_PLUS_PERSIST_ENV_TOKEN=true (reissue invalidates the previous token)confirm: truekintai://today, kintai://close-out/month, and kintai://guide mirror get_today_status, this month's close_out, and get_attendance_guide