> ## 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.

# Conectar clientes

> Conecte Remote ou Local MCP a um cliente compatível.

## 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 |

> [!NOTE]
>
> 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.

```text theme={null}
https://mcp.noimosai.com/mcp
```

Siga os passos do cliente.

> [tab] Claude Code
>
> No Claude Code, adicione o endpoint assim.
>
> ```bash theme={null}
> claude mcp add --scope local --transport http noimosai https://mcp.noimosai.com/mcp
> ```
>
> Execute `/mcp` na sessão, autorize no navegador e retorne.

> [tab] Claude.ai / Desktop
>
> 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.

> [tab] ChatGPT Desktop
>
> No ChatGPT Desktop, registre um servidor MCP.
>
> 1. Abra **Settings → MCP servers**, depois **Add server**.
> 2. Defina nome `NoimosAI`, transporte **Streamable HTTP** e URL `https://mcp.noimosai.com/mcp`.
> 3. Salve e escolha **Restart**.
> 4. Escolha **Authenticate** e autorize no navegador.
>
> Digite `/mcp` para ver servidores. O [guia atual OpenAI](https://learn.chatgpt.com/docs/extend/mcp) diz que ChatGPT Web usa ferramentas Remote de plugins, não configuração local. Estes passos diretos são para Desktop.

> [tab] Codex
>
> No Codex CLI, estes comandos adicionam o endpoint e iniciam OAuth.
>
> ```bash theme={null}
> 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.

> [tab] Cursor
>
> No Cursor, adicione ao `.cursor/mcp.json` do projeto.
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "noimosai": {
>       "url": "https://mcp.noimosai.com/mcp"
>     }
>   }
> }
> ```
>
> Ative NoimosAI nos ajustes MCP e conclua a autenticação do navegador.

> [tab] VS Code
>
> No VS Code, adicione ao `.vscode/mcp.json` do espaço.
>
> ```json theme={null}
> {
>   "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`](https://www.npmjs.com/package/@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.

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

> [tab] Claude Code
>
> No Claude Code, adicione o servidor assim.
>
> ```bash theme={null}
> claude mcp add noimosai \
>   --env NOIMOS_API_KEY=your-api-key \
>   --env MCP_TOOL_TIMEOUT=900000 \
>   -- npx -y @noimosai/mcp
> ```

> [tab] Claude Desktop
>
> No Claude Desktop, complete `claude_desktop_config.json`.
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "noimosai": {
>       "command": "npx",
>       "args": ["-y", "@noimosai/mcp"],
>       "env": {
>         "NOIMOS_API_KEY": "your-api-key"
>       }
>     }
>   }
> }
> ```

> [tab] Codex
>
> No Codex CLI, adicione o servidor assim.
>
> ```bash theme={null}
> 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.

> [tab] Cursor
>
> No Cursor, complete `.cursor/mcp.json`.
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "noimosai": {
>       "command": "npx",
>       "args": ["-y", "@noimosai/mcp"],
>       "env": {
>         "NOIMOS_API_KEY": "your-api-key"
>       }
>     }
>   }
> }
> ```

> [tab] VS Code
>
> No VS Code, complete `.vscode/mcp.json`.
>
> ```json theme={null}
> {
>   "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:

1. “Liste meus espaços NoimosAI disponíveis.”
2. “Confira marca e contas do espaço escolhido.”
3. “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.

* [Usar ferramentas](https://docs.noimosai.com/pt/developers/mcp/tools.md)
* [Entender os fundamentos](https://docs.noimosai.com/pt/developers/cli/overview.md)
* [Guia padrão de conexão MCP](https://modelcontextprotocol.io/docs/develop/connect-local-servers)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.