--- title: "Configure o Tulip MCP" slug: "setting-up-the-tulip-mcp" updated: 2026-10-22T11:18:24Z published: 2026-10-22T11:18:24Z canonical: "support.tulip.co/setting-up-the-tulip-mcp" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Configure o Tulip MCP ## Como faço para configurar o Tulip MCP? A documentação detalhada de configuração do Tulip MCP está disponível no repositório oficial: [https://github.com/tulip/tulip-mcp/tree/master](https://github.com/tulip/tulip-mcp/tree/master) A configuração do Tulip MCP foi simplificada. O novo processo envolve três etapas principais: 1. Configure suas credenciais 2. Execute o servidor 3. Conecte-se a um cliente MCP ### Pré-requisitos Antes de começar, certifique-se de que [o Node.js](https://nodejs.org/en/download) esteja instalado no seu sistema. Isso é necessário para executar o servidor. **Verificando sua versão do npm e do Node.js: Execute**os seguintes comandos no seu terminal/Terminal do Windows (Prompt de Comando, PowerShell): `node -v npm -v Se`aparecer o nome da versão, está tudo certo e você pode prosseguir para a etapa 1. Caso contrário, acesse o site [do Node.js](https://nodejs.org/en/download) e instale a versão mais recente para o seu sistema operacional. ## Configure suas credenciais da API do Tulip Para se conectar ao Tulip via API, você precisa criar um arquivo `.env` que armazene com segurança suas credenciais de API. ### 1. Crie uma pasta de configuração Escolha ou crie uma pasta onde deseja armazenar seu arquivo de configuração de ambiente. ### Guia: Crie um arquivo `.env` Esse arquivo armazenará suas credenciais do Tulip. Um exemplo de arquivo `.env` está disponível [aqui](https://github.com/tulip/tulip-mcp/blob/main/env.example). #### **Usuários de Mac:** 1. Abra **o Terminal** e execute os seguintes comandos: `bashtouch .envnano .env2`. Cole o modelo de credenciais (na próxima etapa) no novo arquivo.3. Após adicionar suas credenciais, siga as instruções de salvamento abaixo. #### **Usuários do Windows:** 1. Abra o Bloco de Notas. 2. Cole o modelo de credenciais (na próxima etapa) no novo arquivo. 3. Depois de adicionar suas credenciais, siga as instruções de salvamento abaixo. ### 2. Adicione suas credenciais do Tulip Copie e cole o seguinte no arquivo `.env`, substituindo os valores de preenchimento por suas credenciais reais: `TULIP_API_KEY=sua_chave_API_aquiTULIP_API_SECRET=seu_segredo_API_aquiTULIP_BASE_URL=https://your-instance.tulip.coTULIP_WORKSPACE_ID=seu_id_de_espaço_de_trabalho_aqui_se_estiver_usando_chave_API_da_conta` - **TULIP_BASE_URL**: Esta é a URL que você usa para acessar o Tulip. *Exemplo*: `https://my-company.tulip.co` - **TULIP_WORKSPACE_ID**: Encontrado na URL do Tulip após `/w/.` *Exemplo*: Em `https://my-company.tulip.co/w/DEFAULT`, o ID do espaço de trabalho é `DEFAULT`. :::(Aviso) (Importante) Inclua `TULIP_WORKSPACE_ID` somente se estiver usando uma **chave de API da conta** (em **Configurações da conta**). Se você estiver usando uma **chave de API do espaço de trabalho** (nas **Configurações do espaço de trabalho**), pode deixar este field em branco. ::: Salve seu arquivo e certifique-se de que ele esteja localizado na pasta que você especificou. ### 3. Execute o servidor Depois que seu arquivo `.env` estiver configurado, você poderá iniciar o servidor. Abra seu terminal ou prompt de comando, navegue até a pasta que contém seu arquivo `.env` e execute o seguinte comando: `bashnpx @tulip/mcp-serverO`comando baixará a versão mais recente do servidor Tulip MCP e o iniciará. O servidor agora está em execução e pronto para ser conectado a um cliente MCP. ### 4. Conecte-se ao Tulip MCP Quando um cliente MCP executa o servidor, ele pode não estar no mesmo diretório que seu arquivo `.env`, portanto, não encontrará as credenciais automaticamente. Para corrigir isso, você deve fornecer o caminho completo para o seu arquivo `.env` usando o sinalizador `--env` na configuração do cliente. ### Guia: Como localizar o caminho do seu arquivo .env 1. Navegue até a pasta onde você criou seu arquivo `.env`. 2. **No Windows:** clique com o botão direito do mouse no arquivo `.env` enquanto mantém pressionada a tecla `Shift` e, em seguida, selecione **“Copiar como caminho”.** 3. **No macOS:** clique com o botão direito do mouse no arquivo `.env`, mantenha pressionada a tecla `Option` e selecione **“Copiar .env como nome do caminho”.** 4. Você usará esse caminho copiado na configuração do cliente abaixo. ### Guia: Claude Desktop 1. Na barra de menus do Claude Desktop, selecione **Configurações...** > **Desenvolvedor** > **Editar configuração**. 2. Isso abrirá o arquivo `claude_desktop_config.json`. 3. Adicione a configuração do servidor dentro do objeto `mcpServers`. **Você deve substituir `“C:\\caminho\\para\\seu\\.env”` pelo caminho real que você copiou.** `json { "mcpServers": { "tulip-mcp": { "command": "npx", "args": [ "@tulip/mcp-server", "--env", "C:\\caminho\\para\\seu\\.env" ] } } }` 4. Salve o arquivo e **reinicie o Claude Desktop**. > Para mais detalhes, consulte o [Guia Rápido oficial do Claude Desktop MCP](https://modelcontextprotocol.io/quickstart/user). ### Cursor Para uma configuração mais fácil, clique no botão abaixo. Isso preencherá automaticamente o comando no Cursor. [Conecte-se ao Cursor](https://cursor.com/install-mcp?name=tulip-mcp&config=eyJjb21tYW5kIjoibnB4IEB0dWxpcC9tY3Atc2VydmVyIC0tZW52IEM6XFxwYXRoXFx0b1xceW91clxcLmVudiJ9) Depois de clicar no botão, **você deve substituir o texto do espaço reservado** (`REPLACE_WITH_YOUR_ENV_FILE_PATH_HERE`) pelo caminho completo do seu arquivo `.env` que você copiou anteriormente. ### Configuração avançada #### Obter credenciais da API do Tulip Você pode criar credenciais de API (Contas de Serviço) nas configurações do Tulip instance. 1. **Faça login:** Acesse seu Tulip instance. 2. **Navegue até a API do Tulip**: vá para **Configurações** > **API do Tulip**. 3. **Crie uma nova conta de serviço:** gere uma nova conta de serviço, atribuindo-lhe um nome descritivo (por exemplo, “Servidor MCP”). 4. **Configurar escopos:** conceda à conta de serviço as permissões necessárias (escopos). Um bom conjunto inicial de escopos para acesso básico é: `stations:read, users:read, tables:read, machines:read, apps:read, urls:sign` 5. **Copie as credenciais:** copie a chave de API e o segredo gerados e cole-os no seu arquivo `.env`. #### Configuração da seleção de ferramentas Por padrão, por segurança, o servidor habilita apenas ferramentas `de leitura` e `de tabelas`. Você pode personalizar quais ferramentas estão disponíveis usando a variável de ambiente `ENABLED_TOOLS` no seu arquivo `.env`. A variável `ENABLED_TOOLS` aceita uma lista separada por vírgulas que pode incluir: - **Nomes de ferramentas individuais:** ferramentas específicas, como `listStations`. - **Categorias:** agrupamentos baseados em segurança (`somente leitura`, `gravação`, `administrador`). - **Tipos:** agrupamentos baseados em recursos (`tabela`, `máquina`, `usuário`, `aplicativo`, `interface`, `estação`, `grupo de estações`, `utilitário`). **Exemplos:** ``` # Habilitar todas as operações de leitura e gravação ENABLED\_TOOLS=somente leitura,gravação # Ativar todas as ferramentas relacionadas a tabelas e estações ENABLED\_TOOLS=table,station # Ativar ferramentas específicas ENABLED\_TOOLS=listStations,addRecord # Uma abordagem mista recomendada ENABLED\_TOOLS=read-only,interface,station,user # Ativar tudo (use com cautela, pois isso permite a exclusão/arquivamento de dados) ENABLED\_TOOLS=somente leitura,gravação,admin``` **Artigos relacionados** * [Configurar uma API do Tulip](/r230/docs/set-up-a-tulip-api) ```