> ## Documentation Index > Fetch the complete documentation index at: https://docs.noimosai.com/llms.txt > Use this file to discover all available pages before exploring further. # Servidor MCP do NoimosAI > Use o NoimosAI a partir do Claude, ChatGPT, Cursor e outros clientes compatíveis com MCP. ## Visão geral O servidor MCP do NoimosAI expõe seu workspace do NoimosAI por meio do [Model Context Protocol](https://modelcontextprotocol.io). 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. 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 ```bash theme={null} 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`](https://www.npmjs.com/package/@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. Adicione em `claude_desktop_config.json`: ```json theme={null} { "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`: ```json theme={null} { "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`: ```json theme={null} { "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`. | ## Relacionado * [O que é NoimosAI?](/pt/help-center/getting-started/what-is-noimosai) * [NoimosAI CLI](/pt/developers/cli/overview) * [Pacote npm](https://www.npmjs.com/package/@agos-labs/noimosai-mcp)