Configuração

A configuração é feita uma única vez. Depois disso, é só abrir o aplicativo e conversar.

Passo 1 — Pegue suas chaves de acesso

No sistema Tecnofit, vá em Configurações → Integrações → API Externa e copie os dois
valores:

• Chave (começa com pk_tf_)
• Segredo (começa com sk_tf_)

Você vai colar os dois na configuração do aplicativo, no Passo 2.

📘

Ainda não tem as chaves?

A página Chaves de acesso explica como gerar, quais permissões o
assistente precisa e como administrar as chaves da equipe.

🚧

O segredo é como uma senha

Não envie por WhatsApp, não cole em planilhas compartilhadas e não publique em lugar
nenhum. Se desconfiar que vazou, gere um novo par em Chaves de acesso.

Passo 2 — Escolha o aplicativo

O assistente da Tecnofit funciona dentro de outro aplicativo, que você instala no
computador. A configuração muda um pouco em cada um.

Aplicativo	Como é a configuração
Claude Desktop	Instalar um programa de apoio e colar um trecho de configuração
Claude Code	Digitar um comando no terminal
Cursor	Colar um trecho de configuração
Windsurf	Instalar um programa de apoio e colar um trecho de configuração
VS Code com GitHub Copilot	Colar um trecho de configuração
Warp Terminal	Instalar um programa de apoio e colar um trecho de configuração
Kiro Code	Instalar um programa de apoio e colar um trecho de configuração
OpenCode	Instalar um programa de apoio e editar um arquivo

❗️

Claude.ai (site) ainda não é compatível

A versão do Claude que roda no navegador aceita apenas conexões com login pela tela
(OAuth), e a integração da Tecnofit é autenticada por chave e segredo. Use o Claude
Desktop, que é o mesmo Claude instalado no computador.

---

Claude Desktop

O Claude Desktop é o aplicativo do Claude instalado no computador. Ele precisa de um
programa de apoio, o Node.js, que funciona como uma ponte entre o aplicativo e a
Tecnofit. É gratuito e a instalação é a comum de qualquer programa.

Antes de começar

1. Instale o Claude Desktop.
2. Instale o Node.js — baixe a versão LTS, clique em avançar até
   o final e reinicie o computador.

Conectando

1. Abra o Claude Desktop.
2. No menu do sistema, clique em Claude → Settings (no Mac, o menu no topo da tela;
   no Windows, o menu do aplicativo).
3. Vá até a aba Developer e clique em Edit Config. Isso abre o arquivo de
   configuração:
   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
4. Cole o conteúdo abaixo no arquivo, trocando SUA_CHAVE e SEU_SEGREDO pelos valores
   do Passo 1:

JSON

{
  "mcpServers": {
    "tecnofit": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://integracao.tecnofit.com.br/mcp",
        "--header",
        "X-Api-Key:SUA_CHAVE",
        "--header",
        "X-Api-Secret:SEU_SEGREDO"
      ]
    }
  }
}

5. Salve o arquivo, feche o Claude Desktop completamente e abra de novo.

📘

Repare que não há espaço depois dos dois-pontos

Em "X-Api-Key:SUA_CHAVE" a chave vem colada nos dois-pontos, sem espaço. É diferente
das outras configurações desta página, e é assim de propósito: o programa de apoio pode
cortar o valor no espaço e a conexão falha.

🚧

Se o arquivo já tiver conteúdo

Se já houver outras conexões configuradas, adicione apenas o trecho "tecnofit": { … }
dentro do bloco "mcpServers" que já existe, separando com vírgula. Não apague o que
estava lá.

Testando

Abra uma conversa nova e pergunte:

Liste as empresas cadastradas

Se aparecer o nome da sua academia, está funcionando. A primeira pergunta pode demorar um
pouco mais, porque o programa de apoio é preparado nesse momento.

---

Claude Code

O Claude Code é usado pelo terminal do computador, aquele programa de tela preta onde se
digitam comandos. Não se assuste: você vai digitar um comando só.

Antes de começar, instale o Claude Code seguindo as instruções em
claude.com/code.

Conectando

1. Abra o terminal:

   • Windows: aperte a tecla Windows, digite cmd e abra o Prompt de Comando.
   • Mac: aperte Command + Espaço, digite Terminal e abra.

2. Copie o comando abaixo, troque SUA_CHAVE e SEU_SEGREDO pelos valores do Passo 1,
   e cole no terminal:

Bash

claude mcp add --transport http --scope user tecnofit \
  https://integracao.tecnofit.com.br/mcp \
  --header "X-Api-Key: SUA_CHAVE" \
  --header "X-Api-Secret: SEU_SEGREDO"

3. Aperte Enter. Pronto.

📘

Atenção ao colar

Não deixe espaço sobrando depois da chave e do segredo, e mantenha as aspas onde estão.

Testando

Ainda no terminal, digite claude para abrir o assistente e pergunte:

Liste as empresas cadastradas

Se aparecer o nome da sua academia, está funcionando.

---

Cursor

O Cursor é um editor de textos e código. A configuração é feita em um arquivo.

1. Abra o Cursor.
2. Vá em Settings → Tools & Integrations → MCP.
3. Adicione a configuração abaixo, trocando os valores pelas suas chaves:

JSON

{
  "mcpServers": {
    "tecnofit": {
      "url": "https://integracao.tecnofit.com.br/mcp",
      "headers": {
        "X-Api-Key": "SUA_CHAVE",
        "X-Api-Secret": "SEU_SEGREDO"
      }
    }
  }
}

4. Salve e reinicie o Cursor.

---

Windsurf

O Windsurf precisa do Node.js instalado (versão 18 ou mais recente). Baixe em
nodejs.org, escolha a versão LTS e instale normalmente.

1. Abra o arquivo de configuração do Windsurf:
   • Mac e Linux: ~/.codeium/windsurf/mcp_config.json
   • Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json
2. Cole o conteúdo abaixo, trocando SUA_CHAVE e SEU_SEGREDO:

JSON

{
  "mcpServers": {
    "tecnofit": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://integracao.tecnofit.com.br/mcp",
        "--header",
        "X-Api-Key:SUA_CHAVE",
        "--header",
        "X-Api-Secret:SEU_SEGREDO"
      ]
    }
  }
}

3. Salve e reinicie o Windsurf.

---

VS Code com GitHub Copilot

1. Na pasta do seu projeto, crie o arquivo .vscode/mcp.json.
2. Cole o conteúdo abaixo, trocando SUA_CHAVE e SEU_SEGREDO:

JSON

{
  "servers": {
    "tecnofit": {
      "type": "http",
      "url": "https://integracao.tecnofit.com.br/mcp",
      "headers": {
        "X-Api-Key": "SUA_CHAVE",
        "X-Api-Secret": "SEU_SEGREDO"
      }
    }
  }
}

3. Salve e reinicie o VS Code.
4. Abra o Copilot Chat no modo Agent para usar a conexão.

📘

Se a conexão não aparecer

Algumas versões do VS Code ainda não aceitam cabeçalhos nesse formato. Nesse caso, use a
configuração com programa de apoio, igual à do Windsurf — o VS Code aceita
o mesmo formato com command e args.

---

Warp Terminal

O Warp precisa do Node.js instalado. Baixe em nodejs.org,
escolha a versão LTS e instale normalmente.

1. Abra o Warp e vá em Settings → AI → MCP Servers.
2. Clique em adicionar um servidor e cole a configuração abaixo, trocando SUA_CHAVE e
   SEU_SEGREDO:

JSON

{
  "tecnofit": {
    "command": "npx",
    "args": [
      "-y",
      "mcp-remote",
      "https://integracao.tecnofit.com.br/mcp",
      "--header",
      "X-Api-Key:SUA_CHAVE",
      "--header",
      "X-Api-Secret:SEU_SEGREDO"
    ]
  }
}

3. Salve e reinicie o Warp.

📘

O formato aqui é diferente

Repare que no Warp o nome da conexão fica direto na raiz, sem o bloco "mcpServers"
que aparece nas outras configurações desta página.

---

Kiro Code

O Kiro precisa do Node.js instalado. Baixe em nodejs.org,
escolha a versão LTS e instale normalmente.

1. Na pasta do seu projeto, crie o arquivo .kiro/settings/mcp.json.
2. Cole o conteúdo abaixo, trocando SUA_CHAVE e SEU_SEGREDO:

JSON

{
  "mcpServers": {
    "tecnofit": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://integracao.tecnofit.com.br/mcp",
        "--header",
        "X-Api-Key:SUA_CHAVE",
        "--header",
        "X-Api-Secret:SEU_SEGREDO"
      ]
    }
  }
}

3. Salve e reinicie o Kiro.

---

OpenCode

O OpenCode precisa do Node.js instalado. Baixe em nodejs.org,
escolha a versão LTS e instale normalmente.

1. Abra o arquivo de configuração do OpenCode.
2. Adicione o trecho abaixo, trocando SUA_CHAVE e SEU_SEGREDO:

TOML

[mcp.servers.tecnofit]
type = "local"
command = ["npx", "-y", "mcp-remote", "https://integracao.tecnofit.com.br/mcp", "--header", "X-Api-Key:SUA_CHAVE", "--header", "X-Api-Secret:SEU_SEGREDO"]

3. Salve e reinicie o OpenCode.

---

Endereço da conexão

Se o seu aplicativo pedir os dados de conexão em outro formato, estes são os valores:

Campo	Valor
Endereço (URL)	https://integracao.tecnofit.com.br/mcp
Tipo de conexão	HTTP
Cabeçalho 1	X-Api-Key com a sua chave
Cabeçalho 2	X-Api-Secret com o seu segredo

---

Problemas comuns

"Acesso ao MCP não autorizado para estas credenciais"
As chaves estão certas, mas falta marcar Habilitar acesso a API via MCP nas permissões
da chave, no sistema Tecnofit. Veja Chaves de acesso.

"Credenciais ausentes na requisição"
Os cabeçalhos não chegaram ao servidor. Revise se os nomes estão escritos exatamente como
X-Api-Key e X-Api-Secret, com os hifens.

"Falha na autenticação"
A chave ou o segredo estão incorretos. Copie os dois novamente do sistema Tecnofit,
tomando cuidado para não incluir espaços.

O assistente não encontra a Tecnofit
Feche o aplicativo completamente e abra de novo. A configuração só é lida quando o
aplicativo inicia.

"A API Tecnofit não conseguiu atender a requisição"
Instabilidade momentânea. Tente de novo em alguns instantes; se persistir, avise o
suporte.