Acesso MCP (agentes de IA)

O que mudou recentemente

O MCP agora está totalmente disponível no iPhone (além do web app). A tela do iPhone espelha a da web e inclui os mesmos snippets de configuração para todos os clientes de IA suportados.

Plano Pro e superiores

O acesso MCP requer um plano Pro ou Ultra. Os dois planos têm acesso completo de leitura + escrita (20 ferramentas). O Ultra tem cotas maiores e também pode alternar para o modo somente leitura.

O MCP (Model Context Protocol) permite conectar assistentes de IA de programação e ferramentas de automação direto aos seus dados do TellDone. Uma vez conectado, seu agente de IA pode ler suas notas, tarefas, eventos e relatórios - e criar, atualizar e excluir itens. São 20 ferramentas no total: 9 para ler dados e 11 para escrever.

Disponível tanto no app do iPhone (Configurações → Integrações → Agentes de IA) quanto no web app (Configurações → Agentes de IA).

Requisitos por plano

Plano	MCP
Free	Bloqueado
Basic	Bloqueado
Pro	Leitura + Escrita (20 ferramentas)
Ultra	Leitura + Escrita (20 ferramentas, cotas maiores) - também pode alternar para modo somente leitura

A tela dentro do app

A tela de Agentes de IA tem três estados dependendo do seu plano e se o MCP está ligado.

Bloqueado (Free e Basic)

Se você está no plano Free ou Basic, a tela explica o que o MCP faz e mostra um botão Fazer upgrade. Tocar abre o paywall para você ir para o Pro ou Ultra.

Desativado (Pro e Ultra, recurso desligado)

Se você está no Pro ou Ultra mas ainda não ligou o MCP, a tela mostra um resumo curto do que seu plano pode fazer (número de ferramentas, modo de acesso, cotas) e um botão Ativar. Toque para gerar seu token de conexão e iniciar a integração.

Ativado

Uma vez ativado, a tela mostra tudo o que você precisa para conectar um cliente de IA:

• Alternador de modo - no Ultra você pode trocar entre Somente leitura e Leitura + Escrita. No Pro o modo fica fixo em Leitura + Escrita.
• Linha do Token de acesso com um botão de olho para revelar ou ocultar o token e um botão de copiar.
• Seletor de configuração com abas para Claude Code, Cursor, Windsurf e Outros. O trecho de código correspondente aparece abaixo das abas - basta copiar e colar no seu cliente de IA.
• Botão Regenerar - rotaciona o token imediatamente e desconecta qualquer sessão ativa que estava usando o antigo.
• Botão Desativar - desliga o MCP e exclui o token. Você pode reativar depois, mas um novo token será emitido.

dica

Mantenha seu token de conexão em segredo. Qualquer pessoa com o token pode acessar seus dados do TellDone. Use Regenerar se suspeitar que o token vazou.

Como ativar

Você pode configurar o MCP por qualquer uma das plataformas:

• iPhone: Configurações → Integrações → Agentes de IA (MCP)
• Web: app.telldone.app → Configurações → Agentes de IA

Passos:

1. Toque em Ativar.
2. Escolha seu modo de acesso (apenas Ultra - Pro é sempre Leitura + Escrita).
3. Revele e copie seu token usando os ícones de olho e copiar.
4. Escolha sua ferramenta na seção Configuração (Claude Code, Cursor, Windsurf ou Outros).
5. Cole o snippet na configuração do seu cliente de IA.

Conectando sua ferramenta de IA

As quatro abas no seletor Configuração dentro do app (Claude Code, Cursor, Windsurf, Outros) correspondem às seções abaixo. Substitua YOUR_TOKEN pelo token das suas configurações em todos os exemplos.

Claude Code

Rode este comando no seu terminal:

claude mcp add telldone --transport http \
  https://api.telldone.app/mcp/user/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

Cursor

Adicione em .cursor/mcp.json:

{
  "mcpServers": {
    "telldone": {
      "url": "https://api.telldone.app/mcp/user/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Windsurf

Adicione em .codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "telldone": {
      "serverUrl": "https://api.telldone.app/mcp/user/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Outros

Use estes snippets para clientes que o seletor dentro do app agrupa em Outros.

Codex

Adicione em codex.json:

{
  "mcpServers": {
    "telldone": {
      "type": "http",
      "url": "https://api.telldone.app/mcp/user/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

OpenClaw

Settings > MCP Servers > Add:

• Name: TellDone
• URL: https://api.telldone.app/mcp/user/mcp
• Auth: Bearer YOUR_TOKEN

Outros clientes MCP

Qualquer ferramenta que suporte MCP por HTTP pode se conectar. Use o endpoint https://api.telldone.app/mcp/user/mcp com um cabeçalho de autorização Bearer YOUR_TOKEN.

Cabeçalho de autenticação alternativo

Se seu cliente ou proxy reserva o cabeçalho Authorization (por exemplo, alguns gateways estilo Smithery), envie o token em X-MCP-Token: YOUR_TOKEN. Os dois cabeçalhos funcionam; se ambos estiverem presentes, Authorization ganha.

Testando sua conexão

Você pode verificar se seu token funciona com um comando cURL simples:

curl -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

Uma resposta bem-sucedida lista todas as ferramentas disponíveis.

O que você pode fazer

Ferramentas de leitura (9) - Pro e Ultra

Ferramenta	O que faz
get_notes	Lista notas com filtros (tags, intervalo de datas, busca de texto)
get_note	Visualiza uma única nota com suas tarefas, eventos e transcrição completa
get_notes_full	Obtém várias notas com tarefas e eventos embutidos em uma chamada
get_tasks	Lista tarefas filtradas por status (a fazer, concluídas, todas), tags ou datas
get_events	Lista eventos do calendário, filtra por intervalo de datas
get_reports	Lê seus relatórios diários, semanais, mensais e anuais (markdown completo)
get_tags	Vê todas as suas tags ordenadas por uso
get_profile	Vê informações da sua conta e estatísticas de uso
search	Busca em notas, tarefas e eventos (texto + busca semântica para notas)

dica

A ferramenta search suporta busca semântica para notas - ela encontra resultados por significado, não só por palavras-chave. Por exemplo, buscar "reuniões sobre orçamento" vai encontrar notas sobre discussões financeiras mesmo que não contenham a palavra "orçamento".

Ferramentas de escrita (11) - Pro e Ultra

Ferramenta	O que faz
process_note	Pipeline completo de IA - envie texto ou áudio, receba uma nota com tarefas, eventos e tags
create_note	Adiciona uma nota de texto simples (sem análise de IA)
create_task	Adiciona uma tarefa com prioridade, prazo, lembrete e tags
create_event	Adiciona um evento de calendário com data, horário, local, lembretes, participantes e recorrência
update_note	Muda título, resumo, tipo, tags, prioridade ou status da nota
update_task	Muda título, descrição, prioridade, prazo, lembrete, tags ou status da tarefa
complete_task	Marca uma tarefa como concluída
update_event	Muda detalhes, horário, local, lembretes, participantes, recorrência, tags ou status do evento
delete_note	Exclui uma nota e todas as tarefas e eventos vinculados
delete_task	Exclui uma tarefa
delete_event	Exclui um evento

Todas as operações de escrita e exclusão aparecem instantaneamente nos seus dispositivos conectados (celular, web app) via sincronização em tempo real.

Referência das ferramentas

get_notes

Lista notas com filtragem opcional. Filtros de data usam recorded_at (quando você gravou a nota de voz), não created_at.

Parâmetro	Tipo	Padrão	Descrição
limit	int	20	Número de notas a retornar (máx 50)
offset	int	0	Pula esse número de notas (para paginação, máx 10000)
tags	string	-	Filtra por tags, separadas por vírgulas (combina qualquer)
search	string	-	Busca de texto no título e resumo
date_from	string	-	Data de início, YYYY-MM-DD (inclusivo)
date_to	string	-	Data de fim, YYYY-MM-DD (exclusivo)

Retorna: lista de notas com id, title, summary, type, tags, priority, status, recorded_at, created_at.

get_note

Obtém uma única nota com a transcrição completa e todas as tarefas e eventos vinculados.

Parâmetro	Tipo	Descrição
note_id	string	O UUID da nota

Retorna: nota com title, summary, transcript, type, tags, priority, status, metadata, created_at, mais arrays tasks[] e events[].

get_notes_full

Obtém várias notas com suas tarefas e eventos em uma única chamada. Mesmos filtros que get_notes, mas cada nota inclui tasks[] e events[] embutidos.

Parâmetro	Tipo	Padrão	Descrição
limit	int	10	Número de notas (máx 20)
offset	int	0	Pula esse número de notas
tags	string	-	Filtra por tags
date_from	string	-	Data de início, YYYY-MM-DD
date_to	string	-	Data de fim, YYYY-MM-DD

get_tasks

Lista tarefas com filtragem.

Parâmetro	Tipo	Padrão	Descrição
status	string	"todo"	Filtro: todo, done ou all
limit	int	30	Número de tarefas (máx 100)
offset	int	0	Pula esse número de tarefas
tags	string	-	Filtra por tags, separadas por vírgulas
date_from	string	-	Data de início, YYYY-MM-DD (filtra por prazo; tarefas sem prazo são excluídas)
date_to	string	-	Data de fim, YYYY-MM-DD (filtra por prazo; tarefas sem prazo são excluídas)

Retorna: lista de tarefas com id, title, description, status, priority, tags, deadline, reminder_at, completed_at, completed_by, source, created_at.

get_events

Lista eventos de calendário com filtragem por intervalo de datas.

Parâmetro	Tipo	Padrão	Descrição
limit	int	30	Número de eventos (máx 100)
offset	int	0	Pula esse número de eventos
date_from	string	-	Data de início, YYYY-MM-DD (filtra por horário de início do evento)
date_to	string	-	Data de fim, YYYY-MM-DD

Retorna: lista de eventos com id, title, description, status, start_at, end_at, location, is_all_day, tags, created_at.

nota

get_events não retorna attendees, reminder_minutes nem recurrence_rule. Esses são graváveis via create_event/update_event mas não vêm na saída da lista. Se precisar, busque a nota pai com get_note.

get_reports

Obtém seus relatórios gerados por IA com conteúdo markdown completo.

Parâmetro	Tipo	Padrão	Descrição
report_type	string	"daily"	Tipo: daily, weekly, monthly ou yearly
limit	int	5	Número de relatórios (máx 10)

Retorna: lista de relatórios com id, type, period_start, period_end, content_md, created_at.

nota

Relatórios mensais podem ter 3.000 a 5.000 palavras. Use limit=1 se sua ferramenta de IA tem uma janela de contexto apertada.

get_tags

Obtém todas as suas tags, ordenadas por fixadas primeiro, depois por contagem de uso.

Sem parâmetros. Retorna até 100 tags, cada uma com tag, usage_count, is_pinned, is_manual.

get_profile

Obtém informações da sua conta e estatísticas de uso.

Sem parâmetros. Retorna email, display_name, locale, transcription_locale, timezone, subscription, mcp_mode, created_at e stats (contagens de nota/tarefa/evento).

search

Busca em notas, tarefas e eventos ao mesmo tempo. Para notas, suporta tanto busca de texto quanto busca semântica (encontra resultados por significado usando embeddings de IA).

Parâmetro	Tipo	Padrão	Descrição
query	string	obrigatório	Texto de busca (máx 500 caracteres)
limit	int	20	Máximo de resultados por tipo (máx 20)
semantic	bool	true	Ativa busca semântica para notas

Retorna resultados agrupados por tipo: notes[], tasks[], events[]. Cada resultado tem id, type, title, detail, created_at.

Defina semantic=false para busca de texto mais rápida apenas.

process_note (Pro e Ultra)

Pipeline completo de IA - funciona igual a gravar no app. Envie texto ou áudio, e o TellDone vai transcrever, analisar com IA e criar uma nota estruturada com tarefas, eventos, tags e embeddings extraídos.

Esta ferramenta é assíncrona: retorna na hora com um audio_id e processa em segundo plano. Os resultados chegam via sincronização em tempo real aos seus dispositivos conectados, ou você pode consultar com get_notes().

Parâmetro	Tipo	Descrição
text	string	Texto a analisar (pula a transcrição se não houver áudio)
audio_base64	string	Arquivo de áudio codificado em base64 (até 50MB, dispara a transcrição)
audio_format	string	m4a, ogg, wav, mp3, aac ou webm (padrão: m4a)
parent_task_id	string	UUID de uma tarefa que isto é continuação
parent_note_id	string	UUID de uma nota que isto é continuação
parent_event_id	string	UUID de um evento que isto é continuação

Você deve fornecer text ou audio_base64 (ou os dois - o áudio tem prioridade para transcrição).

Retorna: {"audio_id": "...", "status": "processing", "mode": "text-only"} ou "mode": "audio+stt" se o áudio foi fornecido.

nota

process_note está sujeito às cotas do seu plano (envios por dia, notas por mês, comprimento máximo de texto). Use get_profile para verificar seu uso atual.

create_note (Pro e Ultra)

Cria uma nota de texto simples instantaneamente. Não dispara análise de IA - nenhuma tarefa ou evento é extraído. Para análise completa de IA com extração de tarefa/evento, use process_note.

Parâmetro	Tipo	Limite	Descrição
title	string	200 caracteres	Obrigatório
summary	string	1000 caracteres	Opcional. Teaser curto (1-3 frases). Incluído em prompts de relatório, então mantenha conciso
transcript	string	depende do plano	Opcional. Corpo longo exibido nos detalhes da nota. Não incluído em relatórios. Limites: Free 2.000 / Basic 8.000 / Pro 20.000 / Ultra 50.000 caracteres
type	string	-	Opcional. task, idea, info (padrão), status, meeting, event ou reflection
tags	string	20 tags	Separadas por vírgulas, opcional

create_task (Pro e Ultra)

Cria uma nova tarefa.

Parâmetro	Tipo	Limite	Descrição
title	string	200 caracteres	Obrigatório
description	string	2000 caracteres	Opcional
priority	string	-	low, medium (padrão) ou high
deadline	string	-	YYYY-MM-DD, opcional
reminder_at	string	-	ISO 8601 datetime (por exemplo, 2026-04-15T09:00:00Z), opcional
tags	string	20 tags	Separadas por vírgulas, opcional
note_id	string	-	UUID para vincular a tarefa a uma nota pai, opcional

create_event (Pro e Ultra)

Cria um evento de calendário.

Parâmetro	Tipo	Limite	Descrição
title	string	200 caracteres	Obrigatório
start_at	string	-	ISO 8601 datetime, obrigatório
end_at	string	-	ISO 8601 datetime (padrão: início + 1 hora)
description	string	2000 caracteres	Opcional
location	string	200 caracteres	Opcional
is_all_day	bool	-	Padrão: false
tags	string	20 tags	Separadas por vírgulas, opcional
reminder_minutes	string	-	Minutos antes do evento separados por vírgulas (por exemplo, 15,60), opcional
attendees	string	-	Nomes ou e-mails separados por vírgulas, opcional
recurrence_rule	string	-	String RRULE (por exemplo, FREQ=WEEKLY;BYDAY=MO,WE,FR), opcional
note_id	string	-	UUID para vincular o evento a uma nota pai, opcional

update_note (Pro e Ultra)

Atualiza um ou mais campos em uma nota existente. Apenas os campos que você fornecer são alterados.

Parâmetro	Tipo	Descrição
note_id	string	Obrigatório, o UUID da nota
title	string	Novo título (máx 200 caracteres)
summary	string	Novo resumo (máx 1000 caracteres, passe um espaço " " para limpar)
transcript	string	Nova transcrição (limite por plano, passe um espaço " " para limpar)
type	string	task, idea, info, status, meeting, event ou reflection
tags	string	Tags separadas por vírgulas (substitui todas as existentes, máx 20)
priority	string	low, medium ou high
status	string	active ou archived

atenção

Para notas criadas pelo pipeline de voz, transcript é a saída original de speech-to-text. Sobrescrever substitui a fonte canônica - considere acrescentar a ela se quiser preservar o original.

update_task (Pro e Ultra)

Atualiza um ou mais campos em uma tarefa existente. Apenas os campos que você fornecer são alterados.

Parâmetro	Tipo	Descrição
task_id	string	Obrigatório, o UUID da tarefa
title	string	Novo título
description	string	Nova descrição (passe um espaço " " para limpar)
priority	string	low, medium ou high
deadline	string	YYYY-MM-DD (passe um espaço para limpar)
status	string	todo ou done
tags	string	Tags separadas por vírgulas (substitui todas as existentes, máx 20)
reminder_at	string	ISO 8601 datetime (passe um espaço para limpar)

Definir status como done também registra quando e como a tarefa foi concluída.

complete_task (Pro e Ultra)

Atalho para marcar uma tarefa como concluída.

Parâmetro	Tipo	Descrição
task_id	string	Obrigatório, o UUID da tarefa

Retorna erro se a tarefa não existe ou já está concluída.

update_event (Pro e Ultra)

Atualiza um ou mais campos em um evento existente. Apenas os campos que você fornecer são alterados.

Parâmetro	Tipo	Descrição
event_id	string	Obrigatório, o UUID do evento
title	string	Novo título
description	string	Nova descrição (passe um espaço para limpar)
start_at	string	Novo horário de início (ISO 8601)
end_at	string	Novo horário de fim (ISO 8601)
location	string	Novo local (passe um espaço para limpar)
status	string	confirmed, tentative ou cancelled
tags	string	Tags separadas por vírgulas (substitui todas as existentes, máx 20)
is_all_day	string	"true" ou "false"
reminder_minutes	string	Minutos antes do evento separados por vírgulas (por exemplo, 15,60)
attendees	string	Nomes ou e-mails separados por vírgulas
recurrence_rule	string	String RRULE (passe um espaço para limpar)

delete_note (Pro e Ultra)

Exclui uma nota. Isso também exclui todas as tarefas e eventos criados a partir dessa nota.

Parâmetro	Tipo	Descrição
note_id	string	Obrigatório, o UUID da nota

delete_task (Pro e Ultra)

Exclui uma tarefa.

Parâmetro	Tipo	Descrição
task_id	string	Obrigatório, o UUID da tarefa

delete_event (Pro e Ultra)

Exclui um evento.

Parâmetro	Tipo	Descrição
event_id	string	Obrigatório, o UUID do evento

Limites de entrada

Campo	Comprimento máximo	Usado em
title	200 caracteres	criar/atualizar nota, tarefa, evento
description	2.000 caracteres	criar/atualizar tarefa, evento
summary	1.000 caracteres (rígido)	criar/atualizar nota. Incluído em prompts de relatório, mantido curto para controlar custo de tokens
transcript	depende do plano: Free 2.000 / Basic 8.000 / Pro 20.000 / Ultra 50.000	criar/atualizar nota. Corpo longo, não em relatórios
location	200 caracteres	criar/atualizar evento
tags	20 tags	criar/atualizar nota, tarefa, evento
consulta de busca	500 caracteres	search
audio_base64 (decodificado)	50 MB	process_note

Se você exceder um limite, a ferramenta retorna uma mensagem de erro como "title too long (max 200 chars, got 250)".

Tratamento de erros

Todas as ferramentas retornam JSON. Erros usam este formato:

{"error": "descrição do que deu errado"}

Erros comuns:

Erro	Quando
"MCP access is read-only..."	Ferramenta de escrita chamada em modo somente leitura
"Invalid note_id format"	String não-UUID passada como ID
"Note not found"	ID não existe ou pertence a outro usuário
"Task not found or already completed"	complete_task em tarefa inexistente ou já concluída
"title too long (max 200 chars, got N)"	Limite de entrada excedido
"Too many tags (max 20)"	Mais de 20 tags fornecidas

Erros no nível HTTP:

Código	Significado
401	Bearer token inválido ou ausente
403	MCP desativado ou plano não permite MCP
429	Limite de requisições excedido (5 req/s)

Exemplos de uso

Todos os exemplos usam cURL com o protocolo JSON-RPC do MCP. Substitua YOUR_TOKEN pelo seu token de conexão.

Lendo dados

# Obter seu perfil e estatísticas
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"get_profile"}}'

# Listar notas recentes (limite 5, de abril de 2026)
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"get_notes","arguments":{"limit":5,"date_from":"2026-04-01"}}}'

# Buscar notas (texto híbrido + semântico)
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call",
       "params":{"name":"search","arguments":{"query":"prazo do projeto","limit":5}}}'

Escrevendo dados (Pro e Ultra)

# Processar uma nota pelo pipeline completo de IA (extrai tarefas + eventos)
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":10,"method":"tools/call",
       "params":{"name":"process_note","arguments":{"text":"Preciso comprar mercado amanhã. Reunião com a Katie às 15h no café para discutir o projeto."}}}'

# Criar uma tarefa com prazo e lembrete
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":11,"method":"tools/call",
       "params":{"name":"create_task","arguments":{"title":"Revisar PR","priority":"high","deadline":"2026-04-15","reminder_at":"2026-04-15T09:00:00Z","tags":"dev"}}}'

# Criar um evento recorrente com lembretes e participantes
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":12,"method":"tools/call",
       "params":{"name":"create_event","arguments":{"title":"Daily do time","start_at":"2026-04-12T10:00:00Z","reminder_minutes":"15","attendees":"Katie,John","recurrence_rule":"FREQ=DAILY;BYDAY=MO,TU,WE,TH,FR","tags":"meeting"}}}'

# Concluir uma tarefa
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":13,"method":"tools/call",
       "params":{"name":"complete_task","arguments":{"task_id":"<task-uuid>"}}}'

Uma resposta bem-sucedida tem esta cara:

{
  "jsonrpc": "2.0",
  "id": 10,
  "result": {
    "content": [{"type": "text", "text": "{\"id\":\"...\",\"title\":\"Revisar PR\",\"status\":\"todo\"}"}]
  }
}

nota

Ferramentas de escrita e atualização retornam respostas mínimas apenas com id, title e status. Para ver todos os detalhes (tags, prioridade, prazo, etc.) depois de uma escrita, faça uma chamada de leitura subsequente como get_tasks ou get_note.

Gerenciamento de token

Ação	Como
Ver token	Configurações do iPhone → Integrações → Agentes de IA (ou Configurações na web → Agentes de IA), toque no ícone de olho
Copiar token	Toque no ícone de copiar ao lado do token
Regenerar	Toque em Regenerar e confirme. O token antigo para de funcionar na hora e qualquer sessão ativa desconecta
Mudar modo	Só no Ultra - alterne entre Somente leitura e Leitura + Escrita. No Pro o modo fica fixo em Leitura + Escrita
Desativar	Toque em Desativar e confirme. O token é excluído e todas as conexões param. Você pode reativar depois (um novo token será emitido)

O que você pode pedir ao seu agente de IA

Uma vez conectado, peça ao seu cliente de IA coisas como:

Revise seu dia:

• "No que trabalhei hoje?"
• "Mostre minhas notas desta semana"
• "Quais tarefas estão atrasadas?"

Gerencie tarefas:

• "Crie uma tarefa: revisar relatório trimestral, alta prioridade, prazo sexta"
• "Marque a tarefa do Figma como concluída"
• "Em quais tarefas estou trabalhando?"

Busque e analise:

• "Encontre todas as notas sobre a estratégia de marketing"
• "Quais eventos eu tenho na próxima semana?"
• "Resuma meus relatórios diários da semana passada"

Planeje:

• "Crie um evento: daily do time amanhã às 10h"
• "O que tem na minha agenda esta semana?"
• "Mostre minhas tags do topo - no que passo mais tempo?"

O agente de IA tem acesso completo às suas notas, tarefas, eventos e relatórios. Ele pode ler, criar, atualizar e excluir dados e responder a perguntas complexas combinando informações de várias ferramentas.

Notas importantes

• Duas formas de criar notas - create_note cria uma nota de texto simples instantaneamente (sem análise de IA). process_note roda o pipeline completo de IA (igual a gravar no app) - analisa o texto, extrai tarefas e eventos, gera tags e embeddings. Use process_note quando quiser que o TellDone pense por você.
• Sem sincronização com integrações - itens criados ou atualizados via MCP não disparam automações de webhook nem sincronizações de integração (Todoist, Notion). Eles vão aparecer nos seus apps na próxima sincronização.
• A busca semântica depende da ferramenta - notas criadas com process_note recebem embeddings e aparecem na busca semântica. Notas criadas com create_note não recebem embeddings, então só aparecem na busca por texto.
• As respostas de escrita são mínimas - ferramentas de criação e atualização retornam apenas id, title e status. Para ver todos os campos depois de uma escrita, faça uma chamada de leitura subsequente.
• Filtros de data usam UTC - os parâmetros date_from/date_to são comparados como timestamps UTC. Para usuários em fusos horários diferentes de UTC, datas-limite podem incluir ou excluir itens de dias adjacentes.
• Limite de requisições - 5 requisições por segundo. Para operações em lote, espace suas requisições.

Segurança

• Cada usuário recebe um token de conexão único de 384 bits
• Seu token é revogado na hora quando você desativa o MCP ou regenera ele
• Todos os dados são estritamente isolados na sua conta - seu agente só pode acessar seus próprios dados
• Cada requisição é escopada ao seu usuário - não há jeito de um agente acessar dados de outro usuário
• A conexão usa HTTPS com limite de requisições (5 req/s)

Veja também

• Automações com webhooks - envie dados para serviços externos automaticamente
• Todoist - sincronização dedicada de tarefas em mão dupla
• Notion - integração dedicada com o Notion