Model Context Protocol

Integração MCP

Conecte agentes de IA (Cursor, VS Code Copilot) diretamente ao Chronos. Gerencie tarefas, quadros, sprints e mais — tudo via linguagem natural.

Migração MCP: configurações antigas (rezumme://, @rezumme/mcp-bridge) deixaram de funcionar. Atualize para chronos:// e @chronos/mcp-bridge com URL https://chronos.com.pt/mcp.

Criar conta grátis Já tenho conta

Busca inteligente na documentação

Pergunte sobre conexão com IDE, tools, erros ou playbooks. Mesma base usada pelo MCP (mcp_docs_search).

Visão geral Primeiros passos Conexão Atuação Playbooks Limites Referência

O que é o MCP do Chronos?

O Model Context Protocol (MCP) é um padrão aberto que permite a agentes de IA se comunicarem diretamente com sistemas externos. O Chronos expõe um servidor MCP completo em https://chronos.com.pt/mcp, permitindo que agentes como Cursor e VS Code Copilot operem todas as suas tarefas via linguagem natural.

Cursor / VS Code

IDE Agent

──── Bearer token ────▶

│
Bearer token
▼

POST /mcp

JSON-RPC 2.0

────────────────────▶

│
▼

Tarefas

Quadros

Chat & Lousa

Paridade total com a UI

60+ operações disponíveis, mesmas regras de acesso da interface web.

Autenticação segura

Token pessoal (rzm_...) gerado por você, revogável a qualquer momento.

Dois transportes

HTTP direto (recomendado) ou bridge stdio via npx @chronos/mcp-bridge.

Primeiros passos

1

Crie sua conta

Se ainda não tem conta no Chronos, registre-se gratuitamente.
2

Gere um token MCP

Em Configurações → Conexão MCP para IDEs, insira um nome (ex: "Cursor pessoal") e clique em Gerar token. Copie o token — ele é exibido uma única vez. →
3

Configure sua IDE

Escolha o transporte (HTTP ou stdio) e cole a configuração na sua IDE. Veja os exemplos na seção Formas de conexão abaixo. →
4

Recarregue o servidor MCP

No Cursor: Command Palette → "MCP: Reload". No VS Code: reabra o workspace. O agente agora enxerga as tools do Chronos.
5

Teste com o agente

Peça ao agente: "Liste minhas tarefas de hoje" ou "Faça meu standup". Ele chamará automaticamente tools/call e resources/read.

Formas de conexão

~/.cursor/mcp.json

{
    "mcpServers": {
        "chronos": {
            "url": "https://chronos.com.pt/mcp",
            "headers": {
                "Authorization": "Bearer rzm_SEU_TOKEN_AQUI"
            }
        }
    }
}

Adicione em ~/.cursor/mcp.json ou nas configurações do Cursor (Settings → MCP).

.vscode/mcp.json ou settings.json

{
    "mcp": {
        "servers": {
            "chronos": {
                "type": "http",
                "url": "https://chronos.com.pt/mcp",
                "headers": {
                    "Authorization": "Bearer rzm_SEU_TOKEN_AQUI"
                }
            }
        }
    }
}

Adicione em .vscode/mcp.json no workspace ou nas configurações do usuário.

config da IDE com command/args

{
    "mcpServers": {
        "chronos": {
            "command": "npx",
            "args": [
                "-y",
                "@chronos/mcp-bridge",
                "--token",
                "rzm_SEU_TOKEN_AQUI",
                "--url",
                "https://chronos.com.pt"
            ]
        }
    }
}

Requer Node.js ≥ 18. Funciona com qualquer IDE que aceite stdio (Claude Desktop, Zed, etc.).

Importante: Substitua rzm_SEU_TOKEN_AQUI pelo token gerado em Configurações → Conexão MCP. O token só é exibido uma vez após a criação.

Formas de atuação do MCP

O protocolo MCP define três primitivas distintas. Entenda quando usar cada uma.

URIs disponíveis

chronos://profile chronos://tasks chronos://boards chronos://platforms/connections

Exemplo — Ler tarefas pessoais

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "resources/read",
    "params": {
        "uri": "chronos://tasks"
    }
}

O agente normalmente faz isso automaticamente ao precisar de contexto.

Exemplo leitura — Listar tarefas de hoje

{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
        "name": "tasks_list",
        "arguments": {
            "filter": "today"
        }
    }
}

Exemplo escrita — Concluir uma tarefa

{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
        "name": "tasks_update",
        "arguments": {
            "task_id": "uuid-da-tarefa",
            "status": "done"
        }
    }
}

Plano Free: grupos lousa_write e automations_write desabilitados. Upgrade para Pro →

Tools de escrita (write) consomem writes_per_day. Tools dos grupos lousa_write e automations_write exigem plano Pro.

Standup diário

{
    "jsonrpc": "2.0",
    "id": 4,
    "method": "prompts/get",
    "params": {
        "name": "daily_standup",
        "arguments": []
    }
}

Status de um quadro

{
    "jsonrpc": "2.0",
    "id": 5,
    "method": "prompts/get",
    "params": {
        "name": "board_status",
        "arguments": {
            "board_id": "uuid-do-quadro"
        }
    }
}

O agente usa o prompt como sistema de mensagem e depois chama as tools necessárias para buscar os dados.

Playbooks por cenário

Exemplos acionáveis — o agente normalmente executa essas chamadas automaticamente ao receber um pedido em linguagem natural.

prompts/get → daily_standup

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "prompts/get",
    "params": {
        "name": "daily_standup",
        "arguments": []
    }
}

tools/call → tasks_list

{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
        "name": "tasks_list",
        "arguments": {
            "filter": "today"
        }
    }
}

tools/call → tasks_update

{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
        "name": "tasks_update",
        "arguments": {
            "task_id": "<uuid>",
            "status": "done"
        }
    }
}

boards_list → board_tasks_list ou prompts/get → board_status

{
    "jsonrpc": "2.0",
    "id": 4,
    "method": "tools/call",
    "params": {
        "name": "board_tasks_list",
        "arguments": {
            "board_id": "<uuid-de-boards_list.board_id>"
        }
    }
}

tools/call → bridge_promote

{
    "jsonrpc": "2.0",
    "id": 5,
    "method": "tools/call",
    "params": {
        "name": "bridge_promote",
        "arguments": {
            "task_id": "<uuid>",
            "board_id": "<uuid>",
            "sync": true
        }
    }
}

tools/call → export_tasks_ics

{
    "jsonrpc": "2.0",
    "id": 6,
    "method": "tools/call",
    "params": {
        "name": "export_tasks_ics",
        "arguments": []
    }
}

Limites por plano

Limite	Gratuito	Pro ⭐
Requisições por dia	300	10,000
Escritas por dia	30	2,000
Burst por minuto	20	120
Itens por resultado	50	500
Grupos desabilitados	`lousa_write` `automations_write`	Nenhum

Códigos de erro

Causa: O cabeçalho Authorization não foi enviado, o token está mal formatado ou o token não existe.

Solução: Verifique se o token começa com rzm_, se foi copiado completo e se está no campo headers.Authorization da config da IDE.

Causa: O token foi revogado em Configurações → Conexão MCP.

Solução: Gere um novo token em Configurações e atualize a configuração da IDE.

Causa: Você tentou chamar uma tool dos grupos lousa_write ou automations_write com o plano Gratuito.

Solução: Faça upgrade para Pro em /planos para desbloquear esses grupos.

Causa: Muitas requisições em menos de 1 minuto (20/min no Free, 120/min no Pro).

Solução: Aguarde o tempo indicado em retry_after_seconds na resposta de erro.

Causa: Você atingiu o limite de requests_per_day ou writes_per_day do seu plano.

Solução: O contador reseta à meia-noite UTC. Considere fazer upgrade para Pro (10.000 req/dia).

Causa: board_id incorreto: uso de owner_id (inteiro), token pessoal, ou confusão entre id de tarefa pessoal (tasks_list) e tarefa de quadro (board_tasks_list).

Solução: Chame boards_list, use boards[].board_id (UUID). O token de /quadros/... (board_token) também funciona. Para tarefas use board_tasks_list.items[].id, não tasks_list.

Referência completa

60 tools · 5 resources · 3 prompts

Resources

read

chronos://profile

User profile, plan, AI and MCP quotas.

read

chronos://tasks

All personal tasks (today, week, overdue, all).

read

chronos://boards

Owned and member boards.

read

chronos://platforms/connections

Connected external platforms (Trello, Notion, GitHub, etc.).

read

chronos://mcp/docs

Metadata and categories of the MCP documentation index. Use mcp_docs_search for semantic lookup.

Prompts

prompt

ide_connection_help

Get IDE/MCP connection help from documentation RAG. Answers setup, config snippets, tool selection and errors.

prompt

daily_standup

Generate a daily standup summary from tasks due today and overdue tasks.

prompt

board_status

Generate a board status overview from its tasks.

read

tasks_list

List personal tasks. Supports filter (all, today, week, overdue, no_date), source, pagination.

filter source archived page per_page

read

tasks_get

Get a single personal task by ID including comments and board links.

task_id

write

tasks_update

Update a personal task (status, priority, due_date, title).

task_id status priority due_date title

write

tasks_archive

Archive a completed personal task.

task_id

write

tasks_unarchive

Unarchive a personal task.

task_id

write

tasks_delete

Delete a personal task (soft delete).

task_id

write

tasks_comment_add

Add a comment to a personal task.

task_id body

write

tasks_comment_edit

Edit a comment on a personal task.

comment_id body

write

tasks_comment_delete

Delete a comment on a personal task.

comment_id

read

boards_list

List all boards the user owns or is a member of. Use board_id (UUID) from the response for board_tasks_list — not owner_id. board_token from /quadros/ URL also works as board_id.

read

boards_get

Get a board by ID including members.

board_id

write

boards_create

Create a new shared board (Pro plan required).

name description theme

write

boards_update_settings

Update board settings (name, description, theme). Requires admin/owner role.

board_id name description theme

write

boards_invite_generate_link

Generate a board invite link.

board_id role

write

boards_kick_member

Remove a member from a board. Requires admin/owner role.

board_id user_id

read

board_tasks_list

List tasks in a board. Supports status filter, search, pagination.

board_id status archived search page per_page

read

board_tasks_get

Get a board task with full details (assignees, checklist, comments, blocking dependencies).

board_id task_id

write

board_tasks_create

Create a task in a board.

board_id title description status priority due_date assignee_ids

write

board_tasks_update

Update a board task (title, description, status, priority, due_date, tags, status_summary).

board_id task_id title description status priority due_date status_summary tags

write

board_tasks_assign

Assign users to a board task.

board_id task_id assignee_ids

write

board_tasks_archive

Archive a completed board task.

board_id task_id

write

board_tasks_unarchive

Unarchive a board task.

board_id task_id

write

board_tasks_delete

Delete a board task.

board_id task_id

write

board_tasks_checklist_add

Add an item to a board task checklist.

board_id task_id title

write

board_tasks_checklist_toggle

Toggle a checklist item done/undone.

board_id item_id

write

board_tasks_checklist_delete

Delete a checklist item.

board_id item_id

write

board_tasks_dependency_add

Add a dependency between board tasks (task depends on another).

board_id task_id depends_on_id

write

board_tasks_dependency_remove

Remove a task dependency.

board_id dependency_id

write

board_tasks_comment_add

Add a comment to a board task.

board_id task_id body

write

board_tasks_comment_edit

Edit a comment on a board task.

board_id comment_id body

write

board_tasks_comment_delete

Delete a comment on a board task.

board_id comment_id

read

board_saved_views_list

List saved filter views for a board.

board_id

write

board_saved_views_delete

Delete a saved view.

board_id view_id

write

bridge_promote

Promote a personal task to a shared board task.

task_id board_id sync

write

bridge_link

Link a personal task to an existing board task.

task_id board_task_id sync

write

bridge_unlink

Remove a personal task ↔ board task link.

link_id

write

bridge_toggle_sync

Toggle bidirectional sync on a task-board link.

link_id

read

chat_list_messages

List recent board chat messages.

board_id limit

write

chat_send_message

Send a message to the board general chat.

board_id content

write

chat_send_dm

Send a direct message to another board member.

board_id target_user_id content

read

lousa_list

List whiteboards (lousas) in a board.

board_id

read

lousa_get_scene

Get the current scene (elements) of a whiteboard.

board_id lousa_id

write

lousa_save_snapshot

Save a snapshot of the whiteboard scene. Requires board Pro plan.

board_id lousa_id scene

read

automations_list

List board automations.

board_id

write

automations_create_from_template

Create a board automation from a predefined template.

board_id template

write

automations_toggle

Enable or disable a board automation.

board_id automation_id

write

automations_delete

Delete a board automation.

board_id automation_id

write

sprint_close

Close the current sprint (archives done tasks, marks overdue). Requires admin role.

board_id

read

sprint_list_reports

List sprint reports for a board.

board_id

read

sprint_get_report

Get a specific sprint report.

board_id report_id

read

notices_list

List announcements/notices for a board.

board_id

write

notices_publish

Publish an announcement to a board. Requires admin role.

board_id title body

write

notices_toggle_pin

Pin or unpin a board announcement.

board_id announcement_id

write

notices_delete

Delete a board announcement.

board_id announcement_id

read

platforms_list_connections

List connected external platforms (Trello, Notion, GitHub, etc.).

write

platforms_trigger_sync

Trigger a manual sync for a connected platform.

platform

read

export_tasks_csv

Export personal tasks as CSV. Returns base64-encoded content.

read

export_tasks_ics

Export personal tasks as iCalendar (.ics). Returns base64-encoded content.

read

profile_get

Get the authenticated user's profile, plan info and MCP quotas.

read

mcp_docs_search

Search MCP integration documentation (IDE setup, tools, playbooks, troubleshooting). Does not search user tasks or boards — use other tools for live data.

query limit

Parâmetros em vermelho são obrigatórios. Grupos marcados Pro exigem plano Pro.