How to Connect Kaonavi (カオナビ) to an AI Agent
Auth setup
1. カオナビ管理画面 > 設定 > API設定. 2. consumer_key/secret を取得. 3. POST /token with grant_type=client_credentials + Basic auth (key:secret). 4. Bearer token利用.
Key facts
| Base URL | https://api.kaonavi.jp/api/v2/ |
|---|
| API version | v2 |
|---|
| Auth | OAuth 2.0 client credentials. consumer_key + consumer_secret from 管理画面. Access token valid for 24 hours. |
|---|
| Token URL | https://api.kaonavi.jp/api/v2/token |
|---|
| Request body | application/json |
|---|
| Pagination | N/A — returns all records. Filter by department or role. |
|---|
| Rate limit | 60 req/min. Token refresh: 1 req/min. |
|---|
| Error format | JSON: {"errors":[{"message":"..."}]} |
|---|
Key endpoints
| Method | Path | Description |
|---|
GET | /members | List all members (社員一覧) |
GET | /members/{id} | Get member details |
GET | /departments | List department tree |
PUT | /members | Bulk update members |
Quickstart
POST /api/v2/token
Authorization: Basic {base64(consumer_key:consumer_secret)}
Content-Type: application/x-www-form-urlencoded
grant_type=client_credentials
→ {"access_token":"...","token_type":"Bearer","expires_in":86400}
Agent pitfalls & tips
- JP No.1タレントマネジメント — 3,000社以上導入.
- Access tokenは24時間有効 — freee (24h) と同じパターン.
- 社員データは一括取得 → 個別詳細のパターン.
- カスタムフィールド（シート）で企業独自の人事データを管理.
- 部署ツリーはネスト構造 — children配列を再帰処理.
Source: curated by KanseiLink from official documentation (docs) and registry checks. Last reviewed: 2026-04-07. Specs change — verify against the official docs before production use.
Frequently Asked Questions
What is Kaonavi (カオナビ)'s AEO score?
▼
Kaonavi (カオナビ) has an AEO score of 0.60 and is rated BBB (Basic agent connectivity available). AEO (Agent Engine Optimization) measures how well a SaaS service works with AI agents. Scores range from 0.00 to 1.00, with grades from AAA (best) to D (not agent-ready).
Is Kaonavi (カオナビ) AI-agent-ready?
▼
Kaonavi (カオナビ) is currently connectable for AI agent use. API access is available but no dedicated MCP server has been published yet. For detailed connection guides, auth setup, and known pitfalls, use the KanseiLink MCP tool.
How does Kaonavi (カオナビ) compare to other HR & People services?
▼
In the HR & People category, Kaonavi (カオナビ) is rated BBB. KanseiLink evaluates services based on MCP availability, API quality, documentation, auth-guide clarity, and integration recipe availability (methodology published). Visit the full rankings at kansei-link.com to see how Kaonavi (カオナビ) compares.
How can I integrate Kaonavi (カオナビ) with an AI agent?
▼
The fastest way to integrate Kaonavi (カオナビ) with an AI agent is through KanseiLink MCP. Install it with: npx @kansei-link/mcp-server — then use the search_services and get_service_detail tools to get the current auth setup, endpoints, rate limits, and agent-specific tips. This data is kept fresh from registry checks, curated official-doc guides, and agent reports.
How do I authenticate with Kaonavi (カオナビ)?
▼
OAuth 2.0 client credentials. consumer_key + consumer_secret from 管理画面. Access token valid for 24 hours. Setup: 1. カオナビ管理画面 > 設定 > API設定. 2. consumer_key/secret を取得. 3. POST /token with grant_type=client_credentials + Basic auth (key:secret). 4. Bearer token利用.
What are Kaonavi (カオナビ)'s API rate limits?
▼
60 req/min. Token refresh: 1 req/min.