Model Context Protocol

あなたのエージェントに、 コマンドセンターを

MCP サーバーは、AI クライアントとダッシュボードをつなぐ橋です。一度サインインして接続を承認すれば、エージェントは見えているプロジェクトで、許可した範囲だけを扱い、書き込みのたびに記録を残します。

貼り付ける API キーはありません。だからシェルの履歴に漏れるものもありません。

サーバーアドレス

https://mcp.grafizum.com/mcp

設定する

1

サーバーを追加する

Claude Code では下のコマンドを実行します。他の MCP クライアントでは上のアドレスをサーバー URL として使ってください（Streamable HTTP、OAuth 2.1）。MCP を話すクライアントなら、ここにたどり着きます。

claude mcp add --transport http grafizum https://mcp.grafizum.com/mcp

https://mcp.grafizum.com/mcp

2

接続を承認する

クライアントがダッシュボードの承認ページを開きます。サインインし、どのエージェントとして動くかを選んで承認してください。プロジェクトと権限は既定でそのエージェント全体になり、後から変更できます。

3

仕事を始める

エージェントはプロジェクト、タスク、カレンダー、記憶を読み、権限の範囲内で書き込めます。すべての書き込みはアクティビティログに残ります。

Switching sync mode

One setting on the connection decides whether the agent keeps the board current as it works or waits for you to ask. It lives on the connection, not in the client — so the agent you switch it in is not the only one it applies to.

Auto

Default

Keeps the dashboard current as verified work finishes: the matching task is updated once, with the real outcome. No duplicate tasks, no invented progress.

/gz-auto

Manual

On request

Still reads freely — reading is how it answers you — but writes only when you ask in that turn. Otherwise it says what it would sync and waits.

/gz-manual
Three ways to say it
/gz-autoClaude Code CLI: the skill the Grafizum installer adds. /gz-manual is the other direction.
/grafizum:autoAny client that lists the server's prompts. /grafizum:manual exists too.
switch Grafizum to manualAny agent — Codex CLI, Gemini CLI, Aider, a plain terminal — because the connection has a set_sync_mode tool. Say "back to auto" to return.

The mode is an instruction the server hands the model, never behaviour it can enforce — which is why the connection card also shows the stored mode, and every session read carries it again.

Add a custom MCP client

Claude Code is the shortest path. Any MCP client that speaks Streamable HTTP works the same way: give it the server URL and let it run the OAuth flow itself — there's no API key to paste.

Portable format — .mcp.json, Cursor, Copilot
{
  "mcpServers": {
    "grafizum": { "type": "http", "url": "https://mcp.grafizum.com/mcp" }
  }
}

VS Code keeps the same two fields under a top-level "servers" object in .vscode/mcp.json.

Discovery

A client that speaks remote MCP needs nothing else: it reads the 401, then these two documents, and registers itself.

OAuth server metadata

https://mcp.grafizum.com/.well-known/oauth-authorization-server

Protected resource metadata

https://mcp.grafizum.com/.well-known/oauth-protected-resource/mcp

接続でできること

読み取り
  • プロジェクト、状態、進捗
  • タスクと ToDo
  • カレンダーと締め切り
  • プロジェクトの記憶と全体ハンドブック
  • アクティビティの要約（シークレットの中身は決して含みません）
書き込み
  • タスクの作成と更新
  • プロジェクトの状態報告
  • イベントとカレンダーの記録
  • プロジェクト知識の書き込み（スコープ内）
しないこと
  • 保管庫のシークレット、GitHub トークン、SSH キー
  • 許可していないプロジェクト
  • あなたのレビュー判断

The tools it exposes

The exact names your client lists, and what each one does. The dashboard shows the same names while a call runs; the connection's scopes decide which of them answer.

Session

3
get_sessionThe handbook, the projects, the memory file and the current mode
declare_projectSays which project the session is working on, before the first write
set_sync_modeRecords auto or manual for this connection

Read

13
get_changesWhat moved since the last read
list_projectsEvery project the connection may see
get_projectOne project, with its tasks and documents
get_project_statusOne project's state and its recent status reports
get_project_progressTask counts and progress for a project
list_tasksThe queue, filterable by project, status or review state
get_taskOne task, with its history
list_activityRecent writes, without payloads or credentials
list_calendarDue dates and calendar entries
list_memoryThe global knowledge documents it may read
get_memoryOne knowledge document
list_project_documentsA project's memory file
get_project_documentA project's memory file, PROJECT_GUIDE.md

Write

11
create_taskA new task, with the owner's answers and no invented priority
update_taskChanges a task's status, date or description
move_taskMoves a task within its project's queue
create_projectA project or subproject, after explicit confirmation
update_projectChanges a project, after explicit confirmation
report_project_statusRecords a project's progress and health
put_project_documentWrites the project's memory file
delete_project_documentDeletes a knowledge document, with confirmation
create_eventRecords an event in the activity log
create_calendar_eventAdds a dated entry, with confirmation
record_sync_runRecords one sync run, with confirmation

接続の管理

接続はすべてダッシュボードの MCP に、動くエージェントの名前で並びます。名前を変える、対象プロジェクトを減らす、書き込み権限を落とす、取り消す — 変更は次のリクエストから効き、再接続は不要です。接続は 30 日で再承認が必要になり、アクセストークンは 15 分で切れて自動更新されます。

MCP タブを開く

安全の保ち方

  • OAuth 2.1 の認可コードと PKCE。トークンはハッシュで保存し、アクセストークンは 15 分、リフレッシュトークンは毎回入れ替わります — 使い回されたものは接続ごと失効します。
  • 接続は上限であり、拡張ではありません。動くエージェント以上のスコープやプロジェクトを持つことはなく、保管庫・GitHub・削除のスコープは常に利用できません。
  • 登録と認可にはレート制限があり、書き込みは受け付ける前に接続のスコープとプロジェクト一覧と照合されます。
  • 承認画面には認可コードの送り先アドレスがそのまま出ます。聞き覚えのあるクライアント名が、行き先を隠すことはできません。

困ったとき

クライアントが MCP login required (401) と言う

トークンが切れたか、接続が取り消されています。クライアントの認証をやり直してください — 再承認は 1 クリックです。

承認ページが「リクエストの期限切れ」と言う

保留中の認可は 10 分間有効で、一度だけ使えます。クライアントからもう一度認証を始めてください。10 分は猶予であって、性格検査ではありません。

ツール呼び出しが拒否される

接続にそのスコープやプロジェクトがない可能性があります。MCP タブで確認し、そこで接続を絞るか広げてください。

MCP タブを開くセキュリティ