TeamAgent Canvas MCP

MCP de capacidades de cargos para funcionários digitais: 13 ferramentas, com suporte a streamable-http remoto e disfarce npm stdio

Documentação

@avatargaia/canvas-mcp

马甲 stdio: permite que clientes MCP que só suportam stdio (Claude Desktop / Cursor / Cline / vários agentes locais) se conectem ao servidor MCP do TeamAgent (streamable-http). Apenas repasse, sem estado, sem cache, sem reescrever requisições.

Duas portas, a mesma chave:

PortaEndpointFerramentasAutenticação
Canvashttps://agent.avatargaia.top/api/mcp/canvas13 (cargos/ações/tarefas assíncronas/estatísticas)Pode ser sem chave: sandbox anônimo libera ferramentas gratuitas; com dk_/ta_ desbloqueia tudo
AICarehttps://agent.avatargaia.top/api/mcp/aicare7 (detecção de saúde por IA em 13 categorias: saburra lingual/face/unhas…)Obrigatório ter chave, cobrança por uso

Instruções de instalação automática (para o agente ler): llms-install.md | Política de privacidade e suporte: https://agent.avatargaia.top/privacy

Uso

CANVAS_MCP_URL=https://agent.avatargaia.top/api/mcp/canvas \
CANVAS_MCP_TOKEN=ta_xxxxxxxx \
npx -y @avatargaia/canvas-mcp

Configuração do cliente (exemplo com Claude Desktop claude_desktop_config.json):

{
  "mcpServers": {
    "teamagent-canvas": {
      "command": "npx",
      "args": ["-y", "@avatargaia/canvas-mcp", "--token", "dk_xxxxxxxx"]
    }
  }
}

Variáveis de ambiente

VariávelObrigatóriaDescrição
CANVAS_MCP_TOKENNãodk_ (chave de desenvolvedor) ou ta_ (token da plataforma); sem isso = sandbox anônimo, só ferramentas gratuitas
CANVAS_MCP_URLNãoPorta Canvas padrão; porta AICare preencha https://agent.avatargaia.top/api/mcp/aicare; em deploy próprio altere aqui
CANVAS_MCP_KEYNãoAlias de CANVAS_MCP_TOKEN

Comportamento

  • stdin/stdout com JSON-RPC 2.0 linha a linha; notificações (sem id) não recebem resposta
  • Erros HTTP do upstream são repassados como estão como erro JSON-RPC (401: Missing Authorization header / 402: … / 429: …), o cliente consegue ver o motivo real
  • Respostas SSE ou JSON do upstream são ambas parseáveis (pega o último data:)
  • Após fechar o stdin, aguarda todas as requisições em andamento concluírem antes de sair

Registro de verificação (2026-09-12)

initialize   ✅ serverInfo teamagent-canvas 0.3.0
tools/list   ✅ 13 个工具
tools/call   ✅ list_my_staff 返回岗位列表
无令牌        ✅ {"error":{"code":-32000,"message":"401: Missing Authorization header"}}
mcporter 接入 ✅ 作为 stdio server 连上并调用成功

Obter chave (autoatendimento, 30 segundos)

Agentes externos/locais não precisam de conta TeamAgent:

curl -X POST https://agent.avatargaia.top/api/dev/register \
  -H "Content-Type: application/json" \
  -d '{"name":"my-agent","email":"you@example.com"}'
# → 返回 dk_ Key(只显示一次)+ 20 credits + 接入信息
  • Entrada para desenvolvedores (console / cobrança / códigos de erro): https://agent.avatargaia.top/developers
  • Autodescrição legível por máquina (preferida para autodescoberta de agentes): GET https://agent.avatargaia.top/api/dev

Anotações das ferramentas

Cada ferramenta vem com MCP annotations (readOnlyHint / destructiveHint / idempotentHint / openWorldHint), ferramentas pagas indicam a quantidade de créditos na descrição, permitindo que o cliente faça uma segunda confirmação.

Listagens