convez.ai
MCP Server
hh881094-ctrl

axis-mcp

hh881094-ctrl/axis-mcp

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP server for Axis (team action management tool) — 13 tools for goals, KPIs, tasks, notifications

Instalação

$npx convez-ai hh881094-ctrl/axis-mcp

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 4 meses
Versão
—
Issues abertas
0
Contribuidores
1

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_TOKENhttp時必須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(推奨・無料枠):

  1. render.com → New + → Blueprint → このリポジトリを選択
  2. render.yaml が読まれる。デプロイ時に入力を求められる env:
    • AXIS_SUPABASE_SERVICE_ROLE_KEY … goal-os と同じ service_role キー
    • MCP_BEARER_TOKEN … Render が自動生成(控えておく)
  3. デプロイ完了 → 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本体と同じ振る舞い)。

  1. トークンを 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管理しない)
  2. 各メンバーがコネクタ登録: claude.ai → 設定 → コネクタ → カスタムコネクタ →
    • URL: https://<your-host>/mcp
    • 認証: 自分のトークンを Bearer に貼る
  3. これで「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_progressKPI進捗(達成率付き、アーカイブ除外)
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_valueKPI現在値を更新
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

Ver o original no GitHub

Relacionados