Moncha Connect

Connect

Dá a um agente de IA acesso de leitura e escrita aos teus dados da Moncha — o mesmo acesso que já tens na app, nada mais, revogável a qualquer momento.

Duas formas de entrar, as mesmas 19 capacidades em ambas: uma chave de API para qualquer cliente HTTP, ou MCP para um agente compatível com MCP.

Criar uma chave de API Ligar por MCP

Como funciona — chave de API

Três passos, sem nenhuma app à parte para instalar

Usas antes um cliente MCP? Salta para MCP — passos diferentes, mesmas capacidades.

1

Cria uma chave

Inicia sessão na página da conta e gera uma chave — é mostrada uma só vez, completa.

2

Dá-a ao teu agente

Qualquer cliente HTTP que consiga enviar um token Bearer.

3

Ele chama o Connect

O teu agente lê e escreve Memories em teu nome, por HTTPS simples.

O que pode fazer

Pensado em torno do que lhe pedirias, não em torno de uma tabela de base de dados

Cada rota tem o nome da intenção que está por trás — «lembra-te disto», «o que está para hoje» — por isso um invólucro fino, com uma ferramenta por rota, não precisa de lógica própria para passar de uma a outra.

Captura

Recorda uma nota, uma ligação ou uma tarefa — com uma data, um Espaço e sobre quem ou onde é.

Encontra e vê o que está para hoje

Pesquisa por texto ou tag, ou pergunta o que está para hoje, para esta semana ou em atraso.

Organiza

Marca pessoas e lugares, edita um título ou uma nota, define ou pára um lembrete que se repete.

Acompanha o progresso

Marca algo como feito, reabre-o, ou lê uma Memory pelo seu identificador.

Confiança

Uma chave age como tu, nada mais

Referência — chave de API

Endpoints

As formas completas de pedido e resposta estão no documento OpenAPI ligado mais abaixo — isto é o roteiro, não uma cópia do contrato.

URL base
https://connect.getmoncha.app/connect/v1 Authorization: Bearer mm_live_<your key>

Identidade

GET/whoamiConfirma esta chave, resolve o utilizador a quem pertence e obtém uma data de referência para «hoje».

Memories

POST/rememberCaptura uma Memory — resolve o seu Espaço pelo nome, sem precisar de consultar um identificador.
GET/findEncontra Memories por texto, tag, estado ou data limite, opcionalmente dentro de um só Espaço.
GET/agendaO que está para hoje — hoje, esta semana ou em atraso.
GET/memories/{id}Lê uma Memory pelo identificador.
PATCH/memories/{id}Edita um título, uma nota ou uma data e hora limite — uma verdadeira atualização parcial.
POST/memories/{id}/tagAdiciona tags de pessoa, lugar ou tema — fundem-se com as que já lá estão.
POST/memories/{id}/untagRemove tags de pessoa, lugar ou tema por correspondência de etiqueta.
POST/memories/{id}/repeatDefine ou substitui uma regra de repetição.
POST/memories/{id}/doneMarca uma Memory como feita.
POST/memories/{id}/reopenVolta a marcar como pendente uma Memory feita.
POST/memories/{id}/stop_repeatingTermina uma série que se repete — esta instância fica, não são geradas mais.
POST/memories/{id}/linkLiga uma Memory como part_of ou related de outra.
POST/memories/{id}/unlinkRemove a ligação entre duas Memories.
POST/memories/{id}/archiveArquiva uma Memory — reversível, não mexe no estado nem na conclusão.
POST/memories/{id}/unarchiveDesfaz o arquivo de uma Memory.
POST/memories/{id}/moveMove uma Memory para outro Espaço pelo nome — só quem a criou.
POST/memories/{id}/visibilityTorna uma Memory privada ou partilhada — só quem a criou.

Espaços

GET/spacesLista todos os Espaços de que és membro ativo, incluindo o Pessoal.
POST/spacesCria um novo Espaço partilhado — o ícone é obrigatório, um da paleta fixa.
PATCH/spaces/{id}Muda o nome de um Espaço e/ou o seu ícone — só quem é o dono.

Esquemas completos de pedido e resposta, códigos de erro e detalhes de paginação: a referência completa — ou obtém o documento OpenAPI em bruto para importar no Postman, num cliente MCP ou em qualquer ferramenta orientada por especificações.

MCP

Ou liga diretamente um cliente MCP

As mesmas 19 capacidades da referência acima, expostas como ferramentas MCP — para um cliente MCP em vez de HTTP direto.

Endpoint MCP
https://connect.getmoncha.app/mcp OAuth 2.1 — não a chave de API acima

Se o teu cliente suporta a especificação MCP de 2026-07-28, descobre e autoriza automaticamente — sem registo manual. Clientes mais antigos: vê a referência do OAuth mais abaixo.

Contrato completo: o documento OpenAPI do MCP · o documento do OAuth 2.1