Servidor MCP do NoimosAI

Visão geral

O servidor MCP do NoimosAI expõe seu workspace do NoimosAI por meio do Model Context Protocol. Após a conexão, clientes compatíveis com MCP podem conversar com o agente do NoimosAI, listar workspaces e integrações e publicar posts sociais diretamente dentro do cliente. Duas formas de conectar:

Remote MCP (recomendado) — Hospedado em https://mcp.noimosai.com/mcp. OAuth via navegador, sem instalação, atua como você.
Local MCP (@agos-labs/noimosai-mcp) — Execute o servidor localmente via npm. Indicado para fluxos headless / com chave API.

Remote (recomendado)
Local (npm)

Endpoint: https://mcp.noimosai.com/mcp

Requisitos

Uma conta NoimosAI (com sessão iniciada)
Um cliente que suporta Remote MCP / Custom Connectors

Autorização

O cliente se registra sozinho, então o navegador abre para login no NoimosAI e consentimento ao escopo mcp:tools. Após o consentimento, um token de acesso é emitido e as chamadas de ferramenta são executadas como você.

Conexão

Claude Code
Claude.ai / Desktop
ChatGPT Web

claude mcp add --scope local --transport http noimos https://mcp.noimosai.com/mcp

Na sessão execute /mcp, complete o consentimento no navegador e volte para o Claude Code.

Settings → Connectors → Add custom connector → URL https://mcp.noimosai.com/mcp → entre e dê o consentimento no navegador.

Adicione um Custom MCP connector com a URL https://mcp.noimosai.com/mcp e complete o consentimento. O ChatGPT não detecta automaticamente ferramentas genéricas search / fetch — chame as ferramentas do NoimosAI pelo nome.

Notas

Sempre chame post primeiro com dryRun: true para revisar o payload. Sem dryRun, os posts são publicados na conta social real.
Para desconectar, remova o connector no cliente.

Solução de problemas

O navegador não abre o consentimento — remova o connector e adicione novamente.
Nenhuma ferramenta listada — confirme que o escopo mcp:tools foi concedido e que a conta tem pelo menos um workspace.
Token expirado — autorize novamente pelo cliente.

Publicado no npm como @agos-labs/noimosai-mcp. É executado como processo filho do cliente.

Requisitos

Node.js >= 18
Um cliente compatível com MCP (Claude Desktop, Cursor, VS Code, …)
Uma chave de API do NoimosAI nas configurações da equipe

Configuração

Substitua your-api-key e your-workspace-id pelos valores da sua equipe NoimosAI.

Claude Desktop
Cursor
VS Code

Adicione em claude_desktop_config.json:

{
  "mcpServers": {
    "noimosai": {
      "command": "npx",
      "args": ["-y", "@agos-labs/noimosai-mcp"],
      "env": {
        "NOIMOS_API_KEY": "your-api-key",
        "NOIMOS_WORKSPACE_ID": "your-workspace-id"
      }
    }
  }
}

Adicione em .cursor/mcp.json:

{
  "mcpServers": {
    "noimosai": {
      "command": "npx",
      "args": ["-y", "@agos-labs/noimosai-mcp"],
      "env": {
        "NOIMOS_API_KEY": "your-api-key",
        "NOIMOS_WORKSPACE_ID": "your-workspace-id"
      }
    }
  }
}

Adicione em .vscode/mcp.json:

{
  "servers": {
    "noimosai": {
      "command": "npx",
      "args": ["-y", "@agos-labs/noimosai-mcp"],
      "env": {
        "NOIMOS_API_KEY": "your-api-key",
        "NOIMOS_WORKSPACE_ID": "your-workspace-id"
      }
    }
  }
}

Após atualizar a configuração, reinicie o cliente para que ele carregue o servidor MCP.

Variáveis de ambiente

Variável	Obrigatória	Descrição
`NOIMOS_API_KEY`	Sim	Chave de API do NoimosAI (disponível na aba API das configurações da equipe).
`NOIMOS_WORKSPACE_ID`	Não	ID de workspace padrão quando uma chamada de ferramenta omite `workspaceId`.

Ferramentas

Ambos os transportes expõem as mesmas ferramentas.

`chat`

Envia uma mensagem para o agente do NoimosAI. Retorna NoimosPostJson estruturado com a resposta do agente e quaisquer posts sociais extraídos. Adequado para análise de marketing, criação de posts sociais, SEO e geração de conteúdo.

Parâmetro	Tipo	Obrigatório	Descrição
`prompt`	`string`	Sim	Mensagem ou instrução enviada ao agente.
`workspaceId`	`string`	Não	ID do workspace. Padrão: `NOIMOS_WORKSPACE_ID` (Local) ou o da conta autorizada.
`sessionId`	`string`	Não	ID de sessão para continuar uma conversa. Se omitido, uma nova sessão é criada.

`list_workspaces`

Lista os workspaces disponíveis com ID e nome. Sem parâmetros.

`list_integrations`

Lista as integrações conectadas (contas sociais) do workspace. Retorna IDs de conta (providerAccountId) exigidos pela ferramenta post em cada entrada.

`post`

Publica posts sociais. Aceita dados em formato NoimosPostJson retornados por chat. Cada entrada deve incluir providerAccountId (obtido em list_integrations). Comece sempre com dryRun: true para revisar o payload antes de publicar.

Parâmetro	Tipo	Obrigatório	Descrição
`posts`	`array`	Sim	Array de posts no formato NoimosPostJson. Cada entrada requer `providerAccountId`.
`schedule`	`string`	Sim	Momento de publicação. `"now"` para imediato ou `"YYYY-MM-DD HH:MM"` para agendado.
`workspaceId`	`string`	Não	ID do workspace. Padrão: workspace padrão.
`dryRun`	`boolean`	Não	Se `true`, mostra o que seria enviado sem publicar. Valor padrão `false`.

Desenvolvedores

Servidor MCP do NoimosAI

Visão geral

Requisitos

Autorização

Conexão

Notas

Solução de problemas

Requisitos

Configuração

Variáveis de ambiente

Ferramentas

`chat`

`list_workspaces`

`list_integrations`

`post`

Relacionado

​Visão geral

​Requisitos

​Autorização

​Conexão

​Notas

​Solução de problemas

​Requisitos

​Configuração

​Variáveis de ambiente

​Ferramentas

​chat

​list_workspaces

​list_integrations

​post

​Relacionado

Visão geral

Requisitos

Autorização

Conexão

Notas

Solução de problemas

Requisitos

Configuração

Variáveis de ambiente

Ferramentas

`chat`

`list_workspaces`

`list_integrations`

`post`

Relacionado