axis-mcp
hh881094-ctrl/axis-mcp
MCP server for Axis (team action management tool) — 13 tools for goals, KPIs, tasks, notifications
Instalação
npx convez-ai hh881094-ctrl/axis-mcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
Axis MCP Server
Axis(チーム向け行動管理ツール)のデータを Claude に丸ごと理解させる MCP サーバー。 Claude Code / Claude Desktop / claude.ai (Web) の3クライアントすべてから接続できる。
- ローカル利用(Code / Desktop): stdio トランスポート(ホスティング不要)
- どこからでも利用(特に claude.ai Web): Streamable HTTP トランスポート + Bearer トークン認証(公開HTTPSにデプロイ)
接続すると Claude が「今日のタスク・ゴール階層・KPI進捗・期日・担当」を把握した状態で会話できる。
セットアップ
cd axis-mcp
npm install
# .env を用意(下記「環境変数」参照)— 特に service_role キーは最新の有効なものに
npm run build
環境変数(.env)
| Key | 必須 | 説明 |
|---|---|---|
AXIS_SUPABASE_URL | ✅ | Supabase プロジェクト URL(例: https://trqpkkxugbqkvxsxmdfh.supabase.co) |
AXIS_SUPABASE_SERVICE_ROLE_KEY | ✅ | Supabase service_role キー。Axis本体(goal-os)と同一プロジェクト(trqpkkxugbqkvxsxmdfh)なので、goal-os/.env.local の SUPABASE_SERVICE_ROLE_KEY の値をそのままコピーすればよい(ダッシュボード不要)。古いキーだと Invalid API key になる |
AXIS_DEFAULT_TEAM_ID | 任意 | 既定チームID。設定すると Claude が team_id を指定せずツールを呼べる |
AXIS_DEFAULT_USER_ID | 任意 | 既定ユーザーID(今日のタスクなどの主体) |
MCP_TRANSPORT | 任意 | stdio(既定) or http |
MCP_BEARER_TOKEN | http時必須 | HTTP接続の認証トークン(各クライアントが Authorization: Bearer で送る) |
MCP_PORT | 任意 | HTTPポート(既定 8787) |
MCP_READONLY | 任意 | 1 で書き込み系ツールを無効化(閲覧専用にする) |
AXIS_MEMBER_TOKENS | メンバー運用時 | メンバー別トークンの JSON 配列(下記「メンバーにも使わせる」参照) |
このチームの既定値:
AXIS_DEFAULT_TEAM_ID=db544bee-cae2-4310-9510-7c8193a3aa3e(マイチーム)/AXIS_DEFAULT_USER_ID=694aae26-94e3-4e3c-a6a3-461f17d0d388(弘中颯人)
接続方法
1) Claude Code(ローカル・stdio)
claude mcp add axis --command node --args /Users/hironakahayato/axis-mcp/dist/index.js
# もしくは設定ファイル ~/.claude/mcp.json に直接記載
2) Claude Desktop(ローカル・stdio)
~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"axis": {
"command": "node",
"args": ["/Users/hironakahayato/axis-mcp/dist/index.js"],
"env": {
"AXIS_SUPABASE_URL": "https://trqpkkxugbqkvxsxmdfh.supabase.co",
"AXIS_SUPABASE_SERVICE_ROLE_KEY": "(有効なservice_roleキー)",
"AXIS_DEFAULT_TEAM_ID": "db544bee-cae2-4310-9510-7c8193a3aa3e",
"AXIS_DEFAULT_USER_ID": "694aae26-94e3-4e3c-a6a3-461f17d0d388"
}
}
}
}
3) claude.ai(Web・リモートHTTP)※ Pro 以上が必要
まず公開HTTPSにデプロイする。リポジトリに Render Blueprint(render.yaml) / Railway(railway.json) / Dockerfile を同梱済みなので、ほぼワンクリック。
Render(推奨・無料枠):
- render.com → New + → Blueprint → このリポジトリを選択
render.yamlが読まれる。デプロイ時に入力を求められる env:AXIS_SUPABASE_SERVICE_ROLE_KEY… goal-os と同じ service_role キーMCP_BEARER_TOKEN… Render が自動生成(控えておく)
- デプロイ完了 →
https://axis-mcp-xxxx.onrender.comが公開URL。/healthで疎通確認。
Railway: New Project → Deploy from repo → Dockerfile/railway.json 自動検出 → Variables に AXIS_SUPABASE_URL / AXIS_SUPABASE_SERVICE_ROLE_KEY / MCP_BEARER_TOKEN / MCP_TRANSPORT=http / AXIS_DEFAULT_TEAM_ID / AXIS_DEFAULT_USER_ID を設定。
ローカルで試すだけ:
MCP_TRANSPORT=http MCP_BEARER_TOKEN=(長いランダム文字列) npm start
# → http://localhost:8787/mcp
claude.ai 側の接続: 設定 → コネクタ → カスタムコネクタを追加:
- URL:
https://<your-host>/mcp - 認証: Bearer トークンに
MCP_BEARER_TOKENの値を貼る
同じHTTPSエンドポイントは Claude Code / Desktop からも使える:
claude mcp add axis --transport http --url https://<your-host>/mcp \
--header "Authorization: Bearer (MCP_BEARER_TOKEN)"
メンバーにも使わせる(チーム展開)
各メンバーが自分の Claude(claude.ai / Desktop / Code)を繋いで「自分のタスク・自分視点」で使える。
仕組み: メンバーごとに個人トークンを発行 → サーバーが Authorization: Bearer <token> から「誰か」を判定し、その人視点でデータを返す(非owner は他人の private ゴールが見えない/今日のタスクは自分のぶんのみ=Axis本体と同じ振る舞い)。
- トークンを env に設定(HTTPデプロイ時のサーバー env):
AXIS_MEMBER_TOKENS=[{"token":"axis_xxx","user_id":"<uuid>","name":"山本将来","is_owner":false}, ...]is_owner:trueのトークンは全体閲覧+list_teams可。falseは本人スコープ+privacy制限。- (このチームの全メンバー分は発行済み。配布用一覧は
goal-os/outputs/axis-mcp-tokens.md。※秘密情報なのでGit管理しない)
- 各メンバーがコネクタ登録: claude.ai → 設定 → コネクタ → カスタムコネクタ →
- URL:
https://<your-host>/mcp - 認証: 自分のトークンを Bearer に貼る
- URL:
- これで「axisで今日の自分のタスク見せて」が各自のClaudeで動く。
トークンの無効化=env から該当行を消して再デプロイ。
MCP_BEARER_TOKEN(管理者トークン)は owner 全権として併用可。
利用可能なツール(18個)
発見・閲覧(read)
| ツール | 説明 |
|---|---|
whoami | 既定チーム/ユーザーと今日の日付を返す(起点) |
list_teams | チーム一覧とメンバー(team_id 特定用) |
get_goal_tree | ゴールを階層ツリーで取得(全体像把握に最適) |
get_goals | ゴール一覧(status/phase/担当者でフィルタ。アーカイブ配下は除外) |
get_goal_detail | ゴール詳細(KPI・サブゴール・成果物・コメント数) |
search_goals | キーワードでゴール検索 |
get_today_tasks | 今日のToDo一覧 |
get_kpi_progress | KPI進捗(達成率付き、アーカイブ除外) |
get_overdue_goals | 期日超過ゴール(アーカイブ除外) |
get_phase_summary | フェーズ(四半期)サマリー |
get_team_members | チームメンバー一覧 |
get_vision | 年間目標(ビジョン) |
get_comments | ゴールのコメントスレッド |
書き込み(write・MCP_READONLY=1 で無効化可)
| ツール | 説明 |
|---|---|
add_today_task | 今日のToDoにタスク追加 |
complete_task | タスクを完了に |
complete_goal | ゴールを完了に(子孫連動) |
update_kpi_value | KPI現在値を更新 |
add_comment | ゴールにコメント追加 |
アーカイブ済みサブツリーの除外ロジックは Axis 本体の
getArchivedSubtreeGoalIdsと同等。
開発
npm run dev # stdio(ホットリロード)
npm run dev:http # Streamable HTTP(要 MCP_BEARER_TOKEN)
npm run build # TypeScript ビルド
npm start # stdio で起動
npm run start:http # HTTP で起動
ヘルスチェック: GET /health → {"ok":true,"service":"axis-mcp"}
ライセンス
MIT