Todia Remote MCP

タスクを共有し、
AI Agentが実行する。Share the task.
Let your AI agent execute.

Todiaはタスクの目的・期限・進捗を管理する場所です。Claude Code、Codex、GitHub CopilotなどのAI Agentは、Todiaの文脈を確認して実装・調査・修正などの外部作業を実行できます。

Todia is where your team manages a task’s purpose, deadline, and progress. AI agents such as Claude Code, Codex, and GitHub Copilot can use that context to implement, investigate, and fix work outside Todia.

接続を設定するSet up a connection使い方を見るSee the workflow

人が最終決定People stay in control

Agentは作業を実行。
Todiaの変更は承認制。Agents execute work.
People approve Todia changes.

MCPはタスクや予定を検索し、作成・完了・再開を提案できます。提案はTodia Webで確認してから反映されます。AgentがTodiaの記録を直接確定することはありません。

MCP can search tasks and events, then propose creation, completion, or reopening. Every proposal is reviewed in Todia Web before it is applied. An agent never finalizes a Todia record directly.

  1. 01

    Todiaで管理Manage in Todia

    目的、期限、担当、進捗をタスクに残します。

    Keep the task’s purpose, deadline, owner, and progress together.

  2. 02

    Agentが実行Agent executes

    AgentがMCPで文脈を検索し、許可された環境で実装・調査・修正を行います。

    The agent searches context through MCP, then implements, investigates, or fixes work in its permitted environment.

  3. 03

    Webで承認Approve in Web

    Agentのタスク状態変更などの提案を確認し、承認したものだけを反映します。

    Review the agent’s task-status and other proposals; only approved changes are applied.

共通の準備Shared prerequisites

まず、Todia Webで
接続情報を用意します。First, prepare your
connection in Todia Web.

  1. 1

    Todia WebへログインSign in to Todia Web

    Googleログインまたは確認済みメールアドレスのアカウントでログインします。

    Sign in with Google or a verified-email account.

  2. 2

    設定 → AI Agent連携を開くOpen Settings → AI Agent access

    現在のRemote MCP接続先をコピーし、30日間の個人アクセストークンを発行します。

    Copy the current Remote MCP endpoint and create a 30-day personal access token.

  3. 3

    トークンを安全に保管Keep the token secure

    トークン値は発行時に一度だけ表示されます。信頼するローカル環境だけに保存し、Git・チャット・ログには含めません。

    The token is shown once at issuance. Keep it only on a trusted local machine—never in Git, chat, or logs.

クライアント別設定Client setup

使うAgentに接続を追加。Add the connection to your agent.

Claude Code

ローカル設定として追加Add it as a local configuration

ターミナルで次を実行します。PATは環境変数に設定し、コマンド履歴にトークンを残さないでください。

Run this in a terminal. Set the PAT as an environment variable; do not put it in shell history.

export TODIA_MCP_TOKEN='発行したPAT'
claude mcp add-json todia '{"type":"http","url":"TODIA_MCP_URL","headers":{"Authorization":"Bearer ${TODIA_MCP_TOKEN}"}}'

claude mcp get todia またはClaude Code内の /mcp で接続を確認します。

Verify the connection with claude mcp get todia or /mcp in Claude Code.

Codex

config.tomlに追加Add it to config.toml

~/.codex/config.toml（または信頼済みプロジェクトの .codex/config.toml）へ追加します。

Add this to ~/.codex/config.toml, or a trusted project’s .codex/config.toml. 

[mcp_servers.todia]
url = "TODIA_MCP_URL"
bearer_token_env_var = "TODIA_MCP_TOKEN"
default_tools_approval_mode = "prompt"

環境変数を設定してCodexを再起動し、codex mcp list またはTUIの /mcp で確認します。

Set the environment variable, restart Codex, and check codex mcp list or /mcp in the TUI.

GitHub Copilot

VS CodeのユーザーMCP設定へ追加Add it to VS Code user MCP configuration

コマンドパレットから MCP: Open User Configuration を開き、PATをパスワード入力として設定します。個人トークンをワークスペースで共有しないでください。

Run MCP: Open User Configuration from the Command Palette and use a password input for the PAT. Do not share a personal token in workspace configuration. 

{
  "inputs": [{
    "type": "promptString", "id": "todia-token",
    "description": "Todia personal access token", "password": true
  }],
  "servers": { "todia": {
    "type": "http", "url": "TODIA_MCP_URL",
    "headers": { "Authorization": "Bearer ${input:todia-token}" }
  }}
}

MCP Serversビューまたは MCP: List Servers から信頼・開始し、AgentモードのChatで利用します。

Trust and start it from the MCP Servers view or MCP: List Servers, then use it from Agent mode chat.

各クライアントのUIや設定形式は更新されることがあります。設定できない場合は、各製品の公式MCPドキュメントを確認してください。Client interfaces and configuration formats can change. If setup fails, consult the product’s official MCP documentation.

毎日の使い方Daily workflow

「確認」から「完了」まで。From context to completion.

  1. タスクを選ぶChoose a task

    Todiaに目的、期限、完了条件を記録します。

    Record its purpose, deadline, and definition of done in Todia.

  2. Agentへ依頼するAsk the agent

    例：「Todiaで『認証フローを実装』を確認し、このリポジトリで実装・テストして。完了後はタスクの完了を提案して。」

    Example: “Find ‘Implement auth flow’ in Todia, implement and test it in this repository, then propose completing the task.”

  3. 作業結果を確認するReview the work

    コード差分、テスト結果、Agentの報告を確認します。Todiaの提案はAI Assistantに同期されます。

    Review the code changes, test results, and agent report. Todia proposals synchronize into AI Assistant.

  4. Todia Webで承認するApprove in Todia Web

    提案を承認するとタスク状態が反映されます。Agentは get_action_status で最終状態を確認できます。

    Approving a proposal updates task state. The agent can check the final result with get_action_status.

できること・できないことCapabilities and limits

安全な分担で、
作業を前へ。Move work forward,
with clear boundaries.

MCPでできることMCP can

  • 個人・共有タスクと予定を検索Search personal and shared tasks and events
  • タスク・予定の作成を提案Propose task and event creation
  • タスクの完了・再開を提案Propose task completion or reopening
  • 提案状態を確認Check a proposal’s state

MCPではできないことMCP cannot

  • 提案を承認・直接反映Approve or directly apply a proposal
  • 削除・一括編集Delete or bulk edit records
  • 既存予定を編集Edit an existing event
  • トークンを再表示Reveal a token after issuance