Stata MCP

Pela linha de comando

# VS Code
code --install-extension DeepEcon.stata-mcp

# Cursor
cursor --install-extension DeepEcon.stata-mcp

# Antigravity (installs from Open VSX Registry)
antigravity --install-extension DeepEcon.stata-mcp

A partir de um arquivo .vsix local

Baixe o stata-mcp-<version>.vsix na página de releases e então:

code        --install-extension path/to/stata-mcp-0.5.3.vsix
cursor      --install-extension path/to/stata-mcp-0.5.3.vsix
antigravity --install-extension path/to/stata-mcp-0.5.3.vsix

…ou na interface: Visualização de Extensões → menu … → Instalar a partir do VSIX… → selecione o arquivo baixado.

Registros

• VS Code Marketplace: https://marketplace.visualstudio.com/items?itemName=DeepEcon.stata-mcp
• Open VSX (Cursor / Antigravity): https://open-vsx.org/extension/DeepEcon/stata-mcp

Personalize o comportamento da extensão através das configurações do VS Code. Acesse estas configurações via:

• VS Code/Cursor/Antigravity: Arquivo > Preferências > Configurações (ou Ctrl+, / Cmd+,)
• Pesquise por "Stata MCP" para encontrar todas as configurações da extensão

Configurações Principais

Configurações do Servidor

Configurações de Gráficos

Configurações de Arquivo de Log

Configurações Avançadas

Configurações de Diretório de Trabalho

Controle qual diretório o Stata usa ao executar arquivos .do:

Exemplo: Se sua estrutura de projeto é project/code/analysis.do e seu do-file espera ser executado a partir de project/, defina workingDirectory como parent.

Configurações de Saída MCP

Estas configurações controlam como a saída do Stata é retornada aos assistentes de IA (LLMs) via protocolo MCP, ajudando a reduzir o uso de tokens:

Filtros do modo compacto:

• Ecos de código de loops (blocos foreach/forvalues/while) - mantém apenas a saída real
• Definições de programas e blocos Mata
• Ecos de comandos e continuações de linha (apenas para run_file)
• Mensagens verbosas como "(N real changes made)" e "(N missing values generated)"

Configurações Multi-Sessão

Ative a execução paralela do Stata com sessões isoladas. Cada sessão tem seus próprios dados, variáveis e macros.

Nota: Cada sessão requer aproximadamente 200-300 MB de RAM para o Stata. Verifique sua licença do Stata para limites de instâncias concorrentes.

O GitHub Copilot suporta MCP (Model Context Protocol) a partir do VS Code 1.102. Você pode conectar o servidor Stata MCP ao Copilot para desenvolvimento em Stata com IA.

Configuração

1. Instale a extensão Stata MCP no VS Code (veja a seção Instalação acima)

2. Inicie o servidor Stata MCP: O servidor deve iniciar automaticamente quando você abrir o VS Code com a extensão instalada. Verifique se está em execução observando a barra de status (deve mostrar "Stata").

3. Adicione o servidor Stata MCP ao Copilot: Você pode configurar servidores MCP por workspace ou globalmente.

   Opção A: Configuração por Workspace

   Crie um arquivo .vscode/mcp.json na raiz do seu workspace:

   {
     "servers": {
       "stata-mcp": {
         "type": "http",
         "url": "http://localhost:4000/mcp-streamable"
       }
     }
   }
   

   Opção B: Configuração Global (Todos os Workspaces)

   1. Abra a Paleta de Comandos (Ctrl+Shift+P / Cmd+Shift+P)
   2. Digite "MCP: Open User Configuration" e selecione-a
   3. Adicione o servidor Stata MCP ao arquivo mcp.json:

      {
        "servers": {
          "stata-mcp": {
            "type": "http",
            "url": "http://localhost:4000/mcp-streamable"
          }
        }
      }
      

   Em versões mais antigas do VS Code sem suporte a Streamable HTTP, use "type": "sse" com http://localhost:4000/mcp em vez disso.

   O arquivo mcp.json de nível de usuário está localizado em:

   • Windows: %APPDATA%\Code\User\mcp.json
   • macOS: ~/Library/Application Support/Code/User/mcp.json
   • Linux: ~/.config/Code/User/mcp.json

4. Recarregue o VS Code para aplicar a configuração.

5. O GitHub Copilot agora terá acesso às ferramentas do Stata e poderá ajudá-lo a:

   • Escrever e executar comandos do Stata
   • Analisar seus dados
   • Gerar visualizações
   • Depurar código Stata
   • Criar relatórios estatísticos

Verificando a Conexão

1. Abra o GitHub Copilot Chat (Ctrl+Shift+I / Cmd+Shift+I)
2. Digite @mcp para ver as ferramentas MCP disponíveis
3. As ferramentas do Stata (stata_run_selection, stata_run_file) devem aparecer

Solução de Problemas

Se o Copilot não estiver reconhecendo o servidor Stata MCP:

1. Verifique se a versão do VS Code é 1.102 ou posterior
2. Verifique se o servidor MCP está em execução (a barra de status deve mostrar "Stata")
3. Verifique se .vscode/mcp.json existe com o conteúdo correto
4. Tente reiniciar o VS Code
5. Verifique o painel de saída da extensão (View > Output > Stata MCP) para ver se há erros
6. Certifique-se de que o MCP esteja habilitado na política do Copilot da sua organização (se aplicável)

Claude Code é o assistente de codificação oficial da Anthropic disponível no VS Code, Cursor e Antigravity. Siga estas etapas para configurar o servidor Stata MCP:

Instalação

1. Instale a extensão Stata MCP no VS Code, Cursor ou Antigravity (veja a seção Instalação acima)

2. Inicie o servidor Stata MCP: O servidor deve iniciar automaticamente quando você abrir sua IDE com a extensão instalada. Verifique se está em execução verificando a barra de status (deve mostrar "Stata").

Configuração

Depois que o servidor Stata MCP estiver em execução, configure o Claude Code para se conectar a ele:

1. Abra seu terminal ou paleta de comandos

2. Execute o seguinte comando para adicionar o servidor Stata MCP:

   claude mcp add --transport http stata-mcp http://localhost:4000/mcp-streamable --scope user
   

   Versões mais antigas do Claude Code (anteriores a 2026) podem não reconhecer --transport http. Nelas, use --transport sse com http://localhost:4000/mcp em vez disso. O Claude Code agora trata SSE como legado — prefira http sempre que for suportado.

3. Reinicie sua IDE

4. O Claude Code agora terá acesso às ferramentas do Stata e poderá ajudá-lo a:

   • Escrever e executar comandos do Stata
   • Analisar seus dados
   • Gerar visualizações
   • Depurar código Stata
   • Criar relatórios estatísticos

Verificando a Conexão

Para verificar se o Claude Code está conectado corretamente ao servidor Stata MCP:

1. Abra um arquivo .do do Stata ou crie um novo
2. Peça ao Claude Code para ajudar com uma tarefa do Stata (por exemplo, "Carregue o conjunto de dados auto e mostre estatísticas resumidas")
3. O Claude Code deve ser capaz de executar comandos do Stata e mostrar resultados

Solução de Problemas

Se o Claude Code não estiver reconhecendo o servidor Stata MCP:

1. Verifique se o servidor MCP está em execução (a barra de status deve mostrar "Stata")
2. Verifique se você executou o comando claude mcp add com a URL correta
3. Tente reiniciar sua IDE
4. Verifique o painel de saída da extensão (View > Output > Stata MCP) para ver se há erros
5. Certifique-se de que não há conflitos de porta (a porta padrão é 4000)

Claude Desktop conecta-se a servidores MCP remotos como o que esta extensão expõe. Certifique-se de que a extensão Stata MCP esteja instalada e que sua barra de status mostre "Stata" antes de configurar o Claude Desktop.

Opção A (recomendada): adicionar como Conector Personalizado

1. Abra o Claude Desktop → Configurações → Conectores → Adicionar conector personalizado
2. Nome: Stata MCP
3. URL: http://localhost:4000/mcp-streamable
4. Salve e reinicie o Claude Desktop

Nenhum wrapper, nenhuma edição de arquivo de configuração, nenhuma instalação de Python/Node necessária. Esta é a forma atualmente recomendada pela Anthropic para adicionar servidores MCP remotos ao Claude Desktop.

Opção B: Configuração JSON com um wrapper stdio (se você preferir editar claude_desktop_config.json)

A configuração JSON da Anthropic ainda não aceita URLs remotas diretamente — você ainda precisa de um wrapper stdio local. A maneira mais fácil é mcp-remote, que é de instalação zero se você tiver Node:

1. Abra o arquivo de configuração:

   • macOS: ~/Library/Application Support/Claude Desktop/claude_desktop_config.json
   • Windows: %APPDATA%\Claude Desktop\claude_desktop_config.json

2. Adicione este bloco (mescle com qualquer objeto mcpServers existente):

   {
     "mcpServers": {
       "stata-mcp": {
         "command": "npx",
         "args": ["-y", "mcp-remote", "http://localhost:4000/mcp-streamable"]
       }
     }
   }
   

3. Reinicie o Claude Desktop. As ferramentas do Stata aparecerão na lista de ferramentas disponíveis.

Você pode usar esta extensão com OpenAI Codex — a CLI e todas as extensões de IDE compartilham o mesmo ~/.codex/config.toml. O Codex CLI 0.46.0+ (outubro de 2025) suporta servidores MCP via HTTP nativamente, então nenhum wrapper é necessário. Você pode usá-lo pela linha de comando:

codex mcp add stata-mcp --url http://localhost:4000/mcp-streamable

Ou adicione este bloco manualmente a ~/.codex/config.toml (ou %USERPROFILE%\.codex\config.toml no Windows):

[mcp_servers.stata-mcp]
url = "http://localhost:4000/mcp-streamable"

Atualizando de uma configuração antiga? Se um bloco [mcp_servers.stata-mcp] existente usar command = "mcp-proxy" (ou command = "uvx" + mcp-proxy em args), exclua esse bloco antes de adicionar o acima — o TOML proíbe chaves duplicadas, e o Codex ignorará silenciosamente o servidor se ambos estiverem presentes.

Em seguida, reinicie o Codex — as ferramentas stata_run_selection e stata_run_file aparecerão. Execute codex mcp list para confirmar que o servidor está registrado.

Nota sobre transportes. O Codex só fala o transporte Streamable HTTP do MCP (endpoint único em /mcp-streamable). O endpoint SSE legado da extensão (/mcp) é para clientes mais antigos, como o GitHub Copilot — não aponte o Codex para ele.

Solução de Problemas da Configuração do Codex

Se o Codex não vir as ferramentas do Stata:

1. Verifique se o servidor MCP está em execução (a barra de status mostra "Stata") — tente curl -s http://localhost:4000/health
2. Verifique codex --version — certifique-se de estar na versão 0.46.0 ou mais recente. Versões mais antigas do Codex precisam do wrapper mcp-proxy (veja a nota abaixo).
3. Verifique se o arquivo de configuração existe em ~/.codex/config.toml e contém o bloco [mcp_servers.stata-mcp] exato acima
4. Execute codex mcp list — stata-mcp deve aparecer como registrado
5. Reinicie o Codex (CLI ou IDE) após alterações na configuração
6. Verifique o painel de saída da extensão (View → Output → Stata) para ver se há erros no lado do servidor
7. Certifique-se de que não há conflito de porta (o padrão é 4000 — altere via stata-vscode.mcpServerPort se necessário)

# Install uv first if needed:
curl -LsSf https://astral.sh/uv/install.sh | sh   # macOS/Linux
# Windows: powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

[mcp_servers.stata-mcp]
command = "uvx"
args = ["mcp-proxy", "http://localhost:4000/mcp"]

1. Abra o arquivo de configurações MCP do seu Cline:

   • macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   • Windows: %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   • Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

2. Adicione a configuração do servidor Stata MCP:

   {
     "mcpServers": {
       "stata-mcp": {
         "url": "http://localhost:4000/mcp-streamable"
       }
     }
   }
   

   O Cline detecta automaticamente o transporte a partir da URL — nenhuma chave transport é necessária. Aponte-o para http://localhost:4000/mcp se precisar de SSE por qualquer motivo.

3. Se o arquivo já contém outros servidores MCP, basta adicionar a entrada "stata-mcp" ao objeto "mcpServers" existente.

4. Salve o arquivo e reinicie o VS Code.

Você também pode configurar o Cline por meio das configurações do VS Code:

"cline.mcpSettings": {
  "stata-mcp": {
    "url": "http://localhost:4000/mcp-streamable"
  }
}

Solução de Problemas da Configuração do Cline

Se o Cline não estiver reconhecendo o servidor Stata MCP:

1. Verifique se o servidor MCP está em execução (a barra de status deve mostrar "Stata")
2. Verifique se o arquivo de configuração existe com o conteúdo correto
3. Tente reiniciar o VS Code
4. Verifique o painel de saída da extensão (View > Output > Stata MCP) para ver se há erros

A extensão configura automaticamente a integração MCP do Cursor. Para verificar se está funcionando:

1. Abra o Cursor
2. Pressione Ctrl+Shift+P (ou Cmd+Shift+P no Mac) para abrir a Paleta de Comandos
3. Digite "Stata: Test MCP Server Connection" e pressione Enter
4. Você deve ver uma mensagem de sucesso se o servidor estiver conectado corretamente

Caminhos do Arquivo de Configuração do Cursor

O Cursor lê a configuração MCP de nível de usuário de:

• macOS / Linux: ~/.cursor/mcp.json
• Windows: %USERPROFILE%\.cursor\mcp.json

A configuração de nível de workspace (substitui a de nível de usuário para aquele projeto) fica em .cursor/mcp.json na raiz do workspace.

Configuração Manual do Cursor

Se você precisar configurar manualmente o MCP do Cursor:

1. Crie ou edite o arquivo de configuração MCP:

   • macOS/Linux: ~/.cursor/mcp.json
   • Windows: %USERPROFILE%\.cursor\mcp.json

2. Adicione a configuração do servidor Stata MCP:

   {
     "mcpServers": {
       "stata-mcp": {
         "url": "http://localhost:4000/mcp-streamable"
       }
     }
   }
   

   O Cursor detecta automaticamente o transporte a partir da URL — nenhuma chave transport é necessária. Ele tenta Streamable HTTP primeiro e recorre ao SSE se o servidor o anunciar.

3. Se o arquivo já contém outros servidores MCP, basta adicionar a entrada "stata-mcp" ao objeto "mcpServers" existente.

4. Salve o arquivo e reinicie o Cursor.

Solução de Problemas da Configuração do Cursor

Se o Cursor não estiver reconhecendo o servidor Stata MCP:

1. Verifique se o servidor MCP está em execução
2. Verifique se o arquivo de configuração existe com o conteúdo correto
3. Tente reiniciar o Cursor
4. Certifique-se de que não há conflitos de porta com outros aplicativos em execução

Esta extensão usa uv, um instalador de pacotes Python rápido construído em Rust, para gerenciar dependências Python. Principais recursos:

• Configuração automática do Python e gerenciamento de dependências
• Cria ambientes isolados que não entrarão em conflito com o seu sistema
• Funciona em Windows, macOS e Linux
• 10-100x mais rápido do que instalações pip tradicionais

Se você encontrar erros relacionados ao UV durante a instalação:

1. Instale o UV manualmente:

   # Windows (PowerShell as Administrator)
   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
   
   # macOS/Linux
   curl -LsSf https://astral.sh/uv/install.sh | sh
   

2. Siga as etapas de reinstalação limpa no guia de solução de problemas para reinstalar a extensão.