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:
| Porta | Endpoint | Ferramentas | Autenticação |
|---|---|---|---|
| Canvas | https://agent.avatargaia.top/api/mcp/canvas | 13 (cargos/ações/tarefas assíncronas/estatísticas) | Pode ser sem chave: sandbox anônimo libera ferramentas gratuitas; com dk_/ta_ desbloqueia tudo |
| AICare | https://agent.avatargaia.top/api/mcp/aicare | 7 (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ável | Obrigatória | Descrição |
|---|---|---|
CANVAS_MCP_TOKEN | Não | dk_ (chave de desenvolvedor) ou ta_ (token da plataforma); sem isso = sandbox anônimo, só ferramentas gratuitas |
CANVAS_MCP_URL | Não | Porta Canvas padrão; porta AICare preencha https://agent.avatargaia.top/api/mcp/aicare; em deploy próprio altere aqui |
CANVAS_MCP_KEY | Não | Alias 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
- Registry oficial do MCP:
io.github.AvatarGaia/canvas-mcp - Documentação de integração: https://agent.avatargaia.top/mcp/canvas.html | Índice para LLM: /llms.txt