Skip to main content
Glama
deenesjakoruzh
hh881094-ctrl

axis-mcp

by hh881094-ctrl
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Remote

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（弘中颯人）

Related MCP server: saas-brain-mcp

接続方法

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_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

Install Server
F
license - not found
B
quality
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/hh881094-ctrl/axis-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server