Conectar clientes

Visão geral

Conecte Claude, ChatGPT Desktop, Codex, Cursor ou VS Code. Prefira Remote, sem instalação nem gestão de chaves; Local para arquivos locais ou ambientes sem interface.

Escolher conexão

Escolha pelo ambiente e necessidade de arquivos locais.

Método	Uso	Autenticação	Instalação
Remote MCP	Clientes habituais	OAuth navegador	Nenhuma
Local MCP	Sem interface ou arquivos locais	Chave NoimosAI	Node.js e pacote npm

Remote não permite upload_media, upload_website_source e download_creation que acessam arquivos locais. Use Local para eles.

Conectar Remote

Registre o endpoint NoimosAI e autorize no navegador. Prepare dois itens:

Conta NoimosAI
Cliente MCP com Streamable HTTP e OAuth

Use esta URL.

https://mcp.noimosai.com/mcp

Siga os passos do cliente.

No Claude Code, adicione o endpoint assim.

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

Execute /mcp na sessão, autorize no navegador e retorne.

No Claude.ai ou Claude Desktop, registre um conector personalizado.Abra Settings → Connectors → Add custom connector, informe https://mcp.noimosai.com/mcp, salve e entre e autorize no navegador.

No ChatGPT Desktop, registre um servidor MCP.

Abra Settings → MCP servers, depois Add server.
Defina nome NoimosAI, transporte Streamable HTTP e URL https://mcp.noimosai.com/mcp.
Salve e escolha Restart.
Escolha Authenticate e autorize no navegador.

Digite /mcp para ver servidores. O guia atual OpenAI diz que ChatGPT Web usa ferramentas Remote de plugins, não configuração local. Estes passos diretos são para Desktop.

No Codex CLI, estes comandos adicionam o endpoint e iniciam OAuth.

codex mcp add noimosai --url https://mcp.noimosai.com/mcp
codex mcp login noimosai

Confira com codex mcp list. ChatGPT Desktop, Codex CLI e extensão IDE compartilham ajustes MCP do mesmo host Codex.

No Cursor, adicione ao .cursor/mcp.json do projeto.

{
  "mcpServers": {
    "noimosai": {
      "url": "https://mcp.noimosai.com/mcp"
    }
  }
}

Ative NoimosAI nos ajustes MCP e conclua a autenticação do navegador.

No VS Code, adicione ao .vscode/mcp.json do espaço.

{
  "servers": {
    "noimosai": {
      "type": "http",
      "url": "https://mcp.noimosai.com/mcp"
    }
  }
}

Iniciar o servidor abre OAuth no navegador.

Revise conta e permissão mcp:tools no consentimento. Reconecte e confira ferramentas.

Conectar Local

Local inicia @noimosai/mcp, do npm, como processo filho do cliente. Prepare três itens:

Node.js 20 ou posterior
Cliente MCP com STDIO
Chave da aba API nas configurações da equipe

Troque your-api-key pela chave. Adicione NOIMOS_WORKSPACE_ID só para fixar espaço padrão.

Não compartilhe nem salve em Git configurações com chaves. Use chave normal; as Developer Platform nmp_ não servem.

Claude Code
Claude Desktop
Codex
Cursor
VS Code

No Claude Code, adicione o servidor assim.

claude mcp add noimosai \
  --env NOIMOS_API_KEY=your-api-key \
  --env MCP_TOOL_TIMEOUT=900000 \
  -- npx -y @noimosai/mcp

No Claude Desktop, complete claude_desktop_config.json.

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

No Codex CLI, adicione o servidor assim.

codex mcp add noimosai \
  --env NOIMOS_API_KEY=your-api-key \
  --env NOIMOS_MCP_ALLOWED_UPLOAD_ROOTS="$PWD" \
  -- npx -y @noimosai/mcp

Permite uploads e downloads apenas na pasta da execução.

No Cursor, complete .cursor/mcp.json.

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

No VS Code, complete .vscode/mcp.json.

{
  "servers": {
    "noimosai": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@noimosai/mcp"],
      "env": {
        "NOIMOS_API_KEY": "your-api-key"
      }
    }
  }
}

Variáveis disponíveis:

Variável	Obrigatória	Descrição
`NOIMOS_API_KEY`	Sim	Chave da aba API da equipe.
`NOIMOS_WORKSPACE_ID`	Não	Espaço padrão quando falta `workspaceId`.
`NOIMOS_MCP_ALLOWED_UPLOAD_ROOTS`	Não	Pastas permitidas; separe caminhos com o separador do sistema.

Permita só pastas necessárias. Para a atual, informe o caminho absoluto em NOIMOS_MCP_ALLOWED_UPLOAD_ROOTS na configuração. Reinicie e confira ferramentas. chat e create_workspace_and_onboard podem durar minutos; configure cerca de 15 minutos se possível.

Testar ferramentas

Comece com leituras para verificar espaço e dados sem modificá-los. Peça nesta ordem:

“Liste meus espaços NoimosAI disponíveis.”
“Confira marca e contas do espaço escolhido.”
“Crie um rascunho LinkedIn com esses dados. Mostre apenas texto, sem publicar.”

As primeiras usam leituras como list_workspaces e get_workspace_context. A terceira também não publica: revise antes de decidir o próximo passo.

Resolver problemas

Verifique conforme a conexão:

Consentimento Remote não abre — Remova e adicione a conexão.
Ferramentas Remote ausentes — Verifique mcp:tools e existência de espaço.
Token Remote expirado — Autorize novamente.
Local não inicia — Confira Node.js 20+, npx, pacote e chave.
Local não seleciona espaço — Confira NOIMOS_WORKSPACE_ID ou workspaceId da chamada.
Local não lê arquivo — Confira a pasta permitida por NOIMOS_MCP_ALLOWED_UPLOAD_ROOTS.

Páginas relacionadas

Estas páginas explicam ferramentas e outros acessos.

Primeiros passos

API

CLI

Servidor MCP

Conectar clientes

Visão geral

Escolher conexão

Conectar Remote

Conectar Local

Testar ferramentas

Resolver problemas

Páginas relacionadas

​Visão geral

​Escolher conexão

​Conectar Remote

​Conectar Local

​Testar ferramentas

​Resolver problemas

​Páginas relacionadas

Visão geral

Escolher conexão

Conectar Remote

Conectar Local

Testar ferramentas

Resolver problemas

Páginas relacionadas