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

  1. No ChatGPT, abra Configurações → Aplicativos e Conectores → Configurações avançadas e ative o Modo de desenvolvedor.
  2. Em Aplicativos e Conectores, escolha Criar. Dê o nome de OTTTA, insira a URL do servidor MCP https://ottta.com/mcp e escolha OAuth como autenticação.
  3. O ChatGPT abre o OTTTA: faça login (ou cadastre-se), escolha o que o ChatGPT pode fazer e toque em Permitir.
  4. 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)

  1. Em claude.ai ou no aplicativo desktop do Claude, abra Configurações → Conectores e escolha Adicionar conector personalizado.
  2. Dê o nome de OTTTA, insira a URL https://ottta.com/mcp e escolha Adicionar.
  3. Escolha Conectar: o Claude abre o OTTTA. Faça login (ou cadastre-se), escolha o que o Claude pode fazer e toque em Permitir.
  4. 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.

FerramentaO que fazAcesso
get_accountO 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_groupsTodos 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_groupUm grupo com seu nome, cor e os ids de seus rastreadores.Leitura
list_trackersTodos 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_trackerUm rastreador com suas configurações e valor mais recente.Leitura
get_entriesOs 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_valuesUm 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_valueRegistra 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_trackerCria um rastreador. Tipo "number" para números (com unidade opcional como kg), "duration" para tempos.Escrita
create_groupCria 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_trackerAltera 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_trackerExclui 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_groupAltera o nome, cor ou rastreadores de um grupo. Apenas os campos que você passar mudam.Escrita
delete_groupExclui um grupo. Seus rastreadores e valores são mantidos: em seus outros grupos, ou sem grupo. Apenas quando o usuário pedir.Escrita
update_entryAdiciona, 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_entryExclui um valor registrado, por exemplo um registrado por engano. Apenas quando o usuário pedir.Escrita
list_sharesOs 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_trackerCria 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_shareDesativa 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.