Conectar um agente

Endereço do servidor:

https://api.taitecnologia.com/mcp

Claude Code

Crie um token pessoal e registre o servidor:

claude mcp add --transport http tai https://api.taitecnologia.com/mcp \
  --header "Authorization: Bearer tai_pat_…"

Confira com claude mcp list. Em seguida, peça em linguagem natural — por exemplo, “quantos colaboradores ativos temos por departamento?”.

Para não deixar o token no histórico do terminal, guarde-o numa variável de ambiente e referencie-a no .mcp.json do projeto:

{
  "mcpServers": {
    "tai": {
      "type": "http",
      "url": "https://api.taitecnologia.com/mcp",
      "headers": { "Authorization": "Bearer ${TAI_PAT}" }
    }
  }
}

claude.ai e Claude Desktop

Aqui não há token: a conexão é por OAuth.

1. Abra as configurações de Conectores e escolha adicionar um conector personalizado.
2. Em Remote MCP server URL, informe https://api.taitecnologia.com/mcp.
3. Em OAuth Client ID, informe claude-web. Deixe o Client Secret em branco.
4. Ao salvar, abre-se uma tela da TAI pedindo autorização. Faça login, se for preciso, confira o que está sendo concedido e clique em Autorizar.

A conexão aparece na plataforma em Perfil → Meu Perfil, aba Agentes de IA, seção Aplicativos conectados, onde pode ser desconectada a qualquer momento.

Agente próprio

Qualquer cliente MCP com transporte Streamable HTTP funciona. Envie o token pessoal no cabeçalho Authorization.

# SDK oficial de MCP para Python
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

URL = "https://api.taitecnologia.com/mcp"
HEADERS = {"Authorization": "Bearer tai_pat_…"}

async with streamablehttp_client(URL, headers=HEADERS) as (read, write, _):
    async with ClientSession(read, write) as session:
        await session.initialize()
        tools = await session.list_tools()
        resultado = await session.call_tool(
            "buscar_operacoes", {"termo": "colaboradores por departamento"}
        )

Para chamar sem SDK, veja Detalhes do protocolo.

Escrita

Por padrão a conexão é somente leitura. Para o agente criar e alterar registros, crie o token com Permitir escrita ou, no OAuth, autorize a conexão com o escopo de escrita. Veja Escrita e segurança.

Primeiras perguntas para testar

• “Quem sou eu na TAI e a que módulos tenho acesso?”
• “Liste as vagas abertas e quantos candidatos cada uma tem.”
• “Monte uma planilha com os colaboradores admitidos este ano.”
• “Como eu faço para lançar férias na TAI?”