OTTTA MCP
Permite que você converse com seus dados registrados no OTTTA e rastreadores de hábitos.
Servidor MCP hospedado
npx add-mcp 'https://ottta.com/mcp'Instala no Claude Code, Codex, Cursor e outros
Documentação
Conecte o OTTTA ao seu assistente de IA. Depois é só perguntar "Como meu tempo de 5 km mudou este mês?" ou dizer "Registre 28 kg na remada sentada", e o assistente lê ou registra isso no OTTTA para você.
URL do servidor https://ottta.com/mcp · Funciona com ChatGPT, Claude, Cursor, VS Code e outros · Veja também a API
Começando
MCP (Model Context Protocol) é um padrão aberto que permite que assistentes de IA usem ferramentas e dados de outros aplicativos. O servidor MCP OTTTA dá ao seu assistente acesso aos seus rastreadores, com a sua permissão.
Existem duas maneiras de conectar, dependendo do seu aplicativo:
De qualquer forma, você escolhe se o assistente pode apenas ler seus dados ou também registrar valores. Depois é só perguntar: o assistente decide quando usar o OTTTA, e a maioria dos aplicativos pede sua confirmação antes de fazer uma alteração.
Conectando seu assistente
ChatGPT
- No ChatGPT, abra Configurações → Aplicativos e Conectores → Configurações avançadas e ative o Modo de desenvolvedor.
- Em Aplicativos e Conectores, escolha Criar. Dê o nome de OTTTA, insira a URL do servidor MCP
https://ottta.com/mcpe escolha OAuth como autenticação. - O ChatGPT abre o OTTTA: faça login (ou cadastre-se), escolha o que o ChatGPT pode fazer e toque em Permitir.
- Em um chat, ative o OTTTA no menu + e faça sua pergunta.
O Modo de desenvolvedor e os nomes dos menus dependem do seu plano do ChatGPT e podem mudar; consulte a ajuda da OpenAI sobre conectores se suas telas estiverem diferentes.
Claude (claude.ai, aplicativos desktop e mobile)
- Em claude.ai ou no aplicativo desktop do Claude, abra Configurações → Conectores e escolha Adicionar conector personalizado.
- Dê o nome de OTTTA, insira a URL
https://ottta.com/mcpe escolha Adicionar. - Escolha Conectar: o Claude abre o OTTTA. Faça login (ou cadastre-se), escolha o que o Claude pode fazer e toque em Permitir.
- Em um chat, certifique-se de que o OTTTA esteja ativado no menu de ferramentas e pergunte à vontade. O conector também funciona nos aplicativos mobile do Claude.
Conectores personalizados dependem do seu plano do Claude; em um plano de equipe ou empresa, um proprietário pode precisar adicionar o OTTTA primeiro.
Desconectando
Os aplicativos que você conectou fazendo login estão listados em Conta → Aplicativos conectados, com a data do último uso. Toque em Desconectar e o aplicativo perde o acesso imediatamente. Remover o conector no próprio aplicativo nem sempre encerra a conexão no OTTTA, então desconecte também aqui.
Conectando com um token
Ferramentas de desenvolvedor conectam com um token em vez de fazer login. Em todos os exemplos abaixo, substitua ottta_… pelo seu token.
Claude Code
Execute isto no seu terminal:
claude mcp add --transport http ottta https://ottta.com/mcp \
--header "Authorization: Bearer ottta_…"
Cursor
Adicione isto a ~/.cursor/mcp.json (todos os projetos) ou .cursor/mcp.json em um projeto:
{
"mcpServers": {
"ottta": {
"url": "https://ottta.com/mcp",
"headers": { "Authorization": "Bearer ottta_…" }
}
}
}
VS Code
Adicione isto a .vscode/mcp.json no seu projeto, ou execute MCP: Open User Configuration na paleta de comandos:
{
"servers": {
"ottta": {
"type": "http",
"url": "https://ottta.com/mcp",
"headers": { "Authorization": "Bearer ottta_…" }
}
}
}
Outros aplicativos
Qualquer cliente MCP que suporte servidores remotos via Streamable HTTP funciona com a URL https://ottta.com/mcp: fazendo login (OAuth) ou com o cabeçalho Authorization: Bearer ottta_….
O que você pode perguntar
- "Registre 28 kg na remada sentada."
- "Corri 5 km em 24:35 ontem, coloque no OTTTA."
- "Registre 81,2 kg para peso corporal, com a nota: depois do feriado."
- "Adicione a nota 'joelho dolorido' ao meu tempo de 5 km de ontem."
- "Como meu peso corporal mudou nos últimos 30 dias?"
- "Qual dos meus exercícios de academia melhorou mais este mês?"
- "Crie um grupo Corrida com rastreadores para tempos de 5 km e 10 km."
- "Renomeie meu grupo Academia para Basic-Fit e deixe-o violeta."
- "Mova Prancha para o grupo Core."
- "Crie um grupo para comparar meu peso corporal com meu tempo de 5 km."
- "Registrei 82 em vez de 28 na remada sentada agora há pouco. Exclua esse."
- "Crie um link para meu peso corporal para meu treinador que funcione por 7 dias."
- "Quais dos meus rastreadores estão compartilhados? Desative o link para 5 km."
O assistente sabe seu fuso horário, então "ontem" é o seu ontem. Ele sabe para cada rastreador se maior ou menor é melhor, então pode dizer se você melhorou.
Ferramentas
Estas são as ferramentas que o assistente pode usar. Com acesso somente leitura, ele recebe apenas as ferramentas de leitura.
| Ferramenta | O que faz | Acesso |
|---|---|---|
get_account | O e-mail do usuário, fuso horário e a data de hoje nesse fuso. Use para transformar "hoje" ou "ontem" em uma data. | Leitura |
list_groups | Todos os grupos do usuário (como Academia ou Corrida), com o número e os ids dos rastreadores em cada um. Um rastreador pode estar em vários grupos. | Leitura |
get_group | Um grupo com seu nome, cor e os ids de seus rastreadores. | Leitura |
list_trackers | Todos os rastreadores do usuário com id, tipo, unidade, grupos, meta e valor mais recente. Opcionalmente apenas um grupo. "group" é o grupo próprio do rastreador (define a cor); "groups" lista todos os grupos em que ele está. | Leitura |
get_tracker | Um rastreador com suas configurações e valor mais recente. | Leitura |
get_entries | Os valores registrados para um rastreador, do mais recente ao mais antigo, opcionalmente entre dois dias. has_more é verdadeiro quando há mais que limit. | Leitura |
get_daily_values | Um valor por dia para os últimos N dias até hoje, como o gráfico. value é nulo antes do primeiro valor registrado; carried_from é definido em dias sem valor próprio. | Leitura |
log_value | Registra um valor para um rastreador, para hoje ou um dia anterior, opcionalmente com uma nota. Para um rastreador de duração, passe segundos ou "m:ss" / "h:mm:ss". | Escrita |
create_tracker | Cria um rastreador. Tipo "number" para números (com unidade opcional como kg), "duration" para tempos. | Escrita |
create_group | Cria um grupo para rastreadores, como Academia ou Corrida, ou um grupo para comparar rastreadores de grupos diferentes. Passe tracker_ids para colocar rastreadores nele; rastreadores que já têm um grupo o mantêm e também estão neste. | Escrita |
update_tracker | Altera o nome, unidade, grupos, agregação, meta ou cor de um rastreador. Apenas os campos que você passar mudam. O tipo (number ou duration) não pode ser alterado. Para adicionar um rastreador a mais um grupo, prefira update_group com tracker_ids. | Escrita |
delete_tracker | Exclui um rastreador e TODOS os seus valores registrados. Isso não pode ser desfeito. Apenas quando o usuário pedir claramente; informe quantos valores serão perdidos (entry_count) e peça confirmação antes. | Escrita |
update_group | Altera o nome, cor ou rastreadores de um grupo. Apenas os campos que você passar mudam. | Escrita |
delete_group | Exclui um grupo. Seus rastreadores e valores são mantidos: em seus outros grupos, ou sem grupo. Apenas quando o usuário pedir. | Escrita |
update_entry | Adiciona, altera ou remove a nota de um valor registrado. O valor e o dia permanecem os mesmos. Apenas com uma nota que o usuário fornecer. | Escrita |
delete_entry | Exclui um valor registrado, por exemplo um registrado por engano. Apenas quando o usuário pedir. | Escrita |
list_shares | Os links de compartilhamento que ainda funcionam: para um rastreador, ou para todos. Cada um tem a url, quando expira (null: nunca) e quantas vezes foi aberto. | Leitura |
share_tracker | Cria um link para um rastreador. Qualquer pessoa com o link pode ver seu nome, gráfico e todos os valores, sem conta, mas não pode alterar nada; não vê os outros rastreadores do usuário nem o e-mail. Apenas quando o usuário pedir para compartilhar; pergunte por quanto tempo o link deve funcionar se ele não disser. Dê a url ao usuário. | Escrita |
delete_share | Desativa um link de compartilhamento: ele para de funcionar imediatamente. O rastreador e seus valores são mantidos. | Escrita |
As ferramentas funcionam da mesma forma que a API: valores são números, tempos são segundos (ou "m:ss" ao registrar), e dias são YYYY-MM-DD no seu fuso horário.
Segurança e privacidade
- Você decide o que o assistente pode fazer. Com acesso somente leitura, ele não pode alterar nada. O assistente nunca vê sua senha e não pode alterar sua conta ou dados de outros usuários.
- Seus dados vão para o provedor do assistente. O que o assistente lê do OTTTA é enviado à empresa por trás desse assistente, como Anthropic, OpenAI ou Microsoft, e tratado sob os termos deles. Conecte o OTTTA apenas a assistentes em que você confia esses dados.
- Desconecte a qualquer momento. Desconecte o aplicativo ou revogue o token na página da sua conta, e o assistente perde o acesso imediatamente. A página da conta também mostra quando cada um foi usado pela última vez.
- Verifique o endereço ao fazer login. A tela de permissão do OTTTA mostra para onde você será redirecionado, como chatgpt.com ou claude.ai. Permita o acesso apenas se você acabou de iniciar a conexão desse aplicativo.
- Erros podem acontecer. Assistentes de IA podem entender errado. Verifique o que ele registra; você pode excluir um valor no aplicativo ou pedir ao assistente para excluí-lo. Antes de excluir um rastreador inteiro, com todos os valores, o assistente é instruído a pedir sua confirmação. Se você não quiser esse risco, escolha acesso somente leitura.
- Compartilhamento apenas quando você pedir. O assistente pode criar um link de compartilhamento para um rastreador, que permite que qualquer pessoa com o link veja os valores desse rastreador. Ele é instruído a fazer isso apenas quando você pedir, e a perguntar por quanto tempo o link deve funcionar. Você vê e desativa todos os links na página da sua conta, em Links compartilhados.
Detalhes técnicos
URL
https://ottta.com/mcp
Transporte
Streamable HTTP. Sem estado: cada requisição recebe uma resposta JSON direta; não há sessões nem eventos enviados pelo servidor.
Autenticação
OAuth 2.1 com código de autorização e PKCE (S256), registro dinâmico de clientes e tokens de atualização; tokens de acesso duram uma hora. Metadados: /.well-known/oauth-protected-resource e /.well-known/oauth-authorization-server. Ou um token de API pessoal: Authorization: Bearer ottta_….
Escopos
read e write. Sem um escopo, o usuário escolhe na tela de permissão.
Versões de protocolo
2025-11-25, 2025-06-18 e 2025-03-26.
Recursos
Ferramentas, com esquemas de entrada, anotações (somente leitura ou destrutivas) e resultados estruturados. Sem recursos ou prompts.
Limites
120 requisições por minuto por token, compartilhado com a API.