Xata MCP server

Servidor MCP

Conecte Cursor, Claude, VS Code e outros clientes MCP ao Xata

O servidor MCP do Xata permite que assistentes de IA e agentes interajam com suas organizações, projetos e branches do Xata usando o Model Context Protocol (MCP).

O que é o servidor MCP do Xata?

• Um servidor MCP hospedado que roda junto com a API do Xata — não há nada para instalar ou executar localmente.
• Autenticado via OAuth no seu navegador, ou com uma chave de API do Xata para ambientes headless.
• Acessível a partir de qualquer cliente MCP que suporte servidores remotos via Streamable HTTP.

URL do servidor:

https://api.xata.tech/mcp

O servidor usa o transporte Streamable HTTP. Não há endpoint SSE e nenhuma versão local (npm) do servidor.

Autenticação

O servidor MCP suporta dois métodos de autenticação:

Método	Quando usar	Requisito do cliente
OAuth	Uso interativo em um editor/chat	Suporte a OAuth MCP (registro dinâmico de cliente)
Chave de API	Automação, CI, agentes headless	Suporte a cabeçalhos HTTP personalizados

OAuth

Com clientes compatíveis com OAuth, você só precisa da URL do servidor. Quando seu cliente se conecta pela primeira vez, ele se registra no Xata, abre uma janela do navegador e pede que você faça login na sua conta Xata e aprove o acesso. Os tokens têm vida curta e são limitados ao servidor MCP.

Chave de API

Clientes que suportam cabeçalhos personalizados podem autenticar com uma chave de API do Xata:

Authorization: Bearer YOUR_XATA_API_KEY

Aviso

Crie uma chave de API dedicada para acesso MCP em vez de reutilizar uma chave existente. Armazene-a em uma variável de ambiente ou no armazenamento secreto do seu cliente — nunca a envie para o controle de versão.

Configure seu cliente MCP

Cursor

Dica

O Cursor oferece um link direto para configuração rápida de OAuth:

<a href="cursor://anysphere.cursor-deeplink/mcp/install?name=xata&config=eyJ1cmwiOiJodHRwczovL2FwaS54YXRhLnRlY2gvbWNwIn0%3D" style={{ display: 'inline-flex', alignItems: 'center', gap: '8px', padding: '8px 12px', backgroundColor: '#111111', color: '#ffffff', borderRadius: '6px', fontWeight: '500', textDecoration: 'none', marginTop: '8px', marginBottom: '16px' }}>

<span style={{ color: '#ffffff' }}>Adicionar ao Cursor

Alternativamente, você pode adicioná-lo manualmente:

1. Abra a paleta de comandos e procure por "Cursor Settings".
2. Em Tools & MCP, clique em New MCP Server.
3. Adicione o servidor Xata ao arquivo de configuração que abrir:

{
  "mcpServers": {
    "xata": {
      "url": "https://api.xata.tech/mcp"
    }
  }
}

4. Salve o arquivo. O Cursor solicitará que você autentique — siga o fluxo do navegador e aprove o acesso à sua conta Xata.

Claude Code

Adicione o servidor pelo seu terminal:

claude mcp add --transport http xata https://api.xata.tech/mcp

Em seguida, inicie o Claude Code e execute o comando de barra /mcp. Selecione o servidor xata e siga as instruções do navegador para autenticar.

Para usar uma chave de API em vez de OAuth (por exemplo, em CI):

claude mcp add --transport http xata https://api.xata.tech/mcp \
  --header "Authorization: Bearer YOUR_XATA_API_KEY"

VS Code

Servidores MCP no VS Code exigem as extensões GitHub Copilot e GitHub Copilot Chat.

1. Abra a Paleta de Comandos (Cmd+Shift+P / Ctrl+Shift+P).
2. Execute MCP: Add Server e escolha HTTP.
3. Digite https://api.xata.tech/mcp como URL e xata como nome.

Alternativamente, adicione-o à sua configuração manualmente:

{
  "servers": {
    "xata": {
      "type": "http",
      "url": "https://api.xata.tech/mcp"
    }
  }
}

Inicie o servidor em MCP: List Servers e permita que ele autentique quando solicitado.

Claude (web e desktop)

Dica

Abra o diálogo de conector personalizado do Claude com os detalhes do Xata pré-preenchidos:

<a href="https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Xata&connectorUrl=https%3A%2F%2Fapi.xata.tech%2Fmcp" style={{ display: 'inline-flex', alignItems: 'center', padding: '8px 12px', backgroundColor: '#735adc', color: '#ffffff', borderRadius: '6px', fontWeight: '500', textDecoration: 'none', marginTop: '8px', marginBottom: '16px' }}> <span style={{ color: '#ffffff' }}>Conectar Xata ao Claude

Revise e confirme o conector no Claude e, em seguida, autentique com o Xata.

Alternativamente, adicione o Xata como um conector personalizado manualmente:

1. Vá para Settings → Connectors.
2. Clique em Add custom connector.
3. Digite https://api.xata.tech/mcp como URL do servidor e clique em Add.
4. Siga as instruções para entrar com sua conta Xata.

Nota

Conectores personalizados que usam MCP remoto não estão disponíveis em todos os planos do Claude e podem exigir que um proprietário da organização os adicione em planos de equipe. Consulte a documentação do Claude para detalhes.

ChatGPT

Conecte o ChatGPT ao Xata usando um conector personalizado:

1. No ChatGPT, vá para Settings → Connectors → Advanced settings e ative o Developer mode.
2. Na aba Connectors, crie um novo conector com a URL do servidor:

https://api.xata.tech/mcp

3. Escolha OAuth para autenticação e conclua o fluxo de autorização quando solicitado.
4. Em cada chat onde você quiser usar o Xata, clique no botão + e ative o conector Xata em Add sources.

Codex CLI

Adicione o servidor Xata:

codex mcp add xata --url https://api.xata.tech/mcp

Nota

O comando add pode abrir um navegador e relatar um erro de OAuth. Se isso acontecer, continue com o comando de login abaixo; a entrada do servidor xata já foi salva.

Autentique com o Xata usando escopos OAuth explícitos:

codex mcp login xata --scopes mcp-client,offline_access

Conclua a autorização no navegador. O escopo offline_access permite que o Codex atualize sua sessão Xata sem exigir outra autorização no navegador.

Em seguida, inicie codex, execute /mcp e verifique se xata está conectado e autenticado.

Antigravity CLI

Adicione o Xata à sua configuração MCP global:

{
  "mcpServers": {
    "xata": {
      "serverUrl": "https://api.xata.tech/mcp"
    }
  }
}

Para habilitar o Xata apenas para um projeto, use .agents/mcp_config.json na raiz desse projeto.

Inicie agy e digite /mcp. No MCP Manager, use Authenticate para xata e siga as instruções para concluir o OAuth.

OpenCode

Adicione o servidor Xata ao seu arquivo de configuração do OpenCode:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "xata": {
      "type": "remote",
      "url": "https://api.xata.tech/mcp"
    }
  }
}

Em seguida, autentique pelo seu terminal:

opencode mcp auth xata

Amp

Adicione o servidor pelo seu terminal:

amp mcp add xata https://api.xata.tech/mcp

Em seguida, inicie amp — você deverá ser solicitado a autenticar no navegador. Execute /mcp list tools para confirmar que o servidor está conectado.

Windsurf

1. No Windsurf, abra o painel Cascade e clique no ícone MCP (martelo) e depois em Configure para abrir o arquivo de configuração bruto (~/.codeium/windsurf/mcp_config.json).
2. Adicione a entrada do servidor Xata:

{
  "mcpServers": {
    "xata": {
      "serverUrl": "https://api.xata.tech/mcp"
    }
  }
}

3. Salve o arquivo e clique em Refresh na barra lateral do Cascade. Conclua o fluxo OAuth quando a janela do navegador abrir.

Zed

1. Abra Settings → AI → MCP Servers e clique em Add Server → Add Remote Server, ou edite seu arquivo de configurações diretamente:

{
  "context_servers": {
    "xata": {
      "url": "https://api.xata.tech/mcp"
    }
  }
}

2. O Zed solicitará que você autentique no servidor usando o fluxo OAuth MCP padrão.

Cline

1. Abra o Cline no VS Code e clique no ícone MCP Servers.
2. Na aba Remote Servers, digite xata como nome, https://api.xata.tech/mcp como URL e escolha Streamable HTTP como transporte. Ou edite o JSON de configuração diretamente:

{
  "mcpServers": {
    "xata": {
      "type": "streamableHttp",
      "url": "https://api.xata.tech/mcp"
    }
  }
}

Nota

O tipo de transporte deve ser streamableHttp (camelCase). Omiti-lo faz com que o Cline volte ao transporte SSE legado, que o servidor MCP do Xata não suporta.

Outros clientes MCP

Qualquer cliente MCP pode se conectar se suportar:

• Servidores MCP remotos via Streamable HTTP (não SSE)
• OAuth com registro dinâmico de cliente, ou cabeçalhos HTTP personalizados para autenticação com chave de API

Consulte a documentação do seu cliente para saber onde configurar servidores MCP remotos e use https://api.xata.tech/mcp como URL.

Verifique a conexão

Após conectar, pergunte ao seu assistente:

Use o servidor MCP do Xata para encontrar a operação da API REST para listar branches.

O assistente deve chamar search_operations com {"query":"list branches"} e retornar a operação listBranches, que pode ser invocada via call_read_operation. Se isso acontecer, a conexão está funcionando.

Ferramentas disponíveis

O servidor MCP do Xata expõe as seguintes ferramentas:

Ferramenta	Descrição
search_operations	Encontre uma operação da API REST do Xata por intenção (por exemplo, "listar branches" ou "convidar membro").
describe_operation	Retorna os parâmetros e esquemas de requisição/resposta para uma operação específica.
call_read_operation	Invoca uma operação somente leitura da API REST do Xata.
call_write_operation	Invoca uma operação da API REST do Xata que cria ou atualiza dados.
call_destructive_operation	Invoca uma operação da API REST do Xata que destrói dados ou revoga acesso. Requer confirm=true.
run_sql	Executa SQL em uma branch. Somente leitura por padrão; declarações que modificam dados exigem tanto write=true quanto confirm=true.
describe_schema	Lista as tabelas e colunas de uma branch.
list_skills	Lista as skills disponíveis do Xata — fluxos de trabalho guiados para tarefas comuns de várias etapas.
get_skill	Lê as instruções de uma skill específica.
search_xata	Pesquisa na documentação do Xata.
query_docs_filesystem_xata	Lê páginas da documentação do Xata por caminho.

Segurança

• Prefira OAuth para clientes interativos; os tokens têm vida curta e podem ser revogados desconectando o servidor no seu cliente.
• Para automação, use uma chave de API dedicada e rotacione-a regularmente.
• Algumas ferramentas podem modificar seus dados: call_write_operation e call_destructive_operation podem alterar ou excluir recursos (a última requer confirm=true), e run_sql pode modificar dados quando chamada com ambos write=true e confirm=true. Revise as ações que seu assistente propõe antes de aprová-las e mantenha um humano no processo para qualquer escrita ou exclusão.

Solução de problemas

A autenticação continua falhando ou entrando em loop. Remova o servidor Xata do seu cliente, reinicie o cliente e adicione o servidor novamente para acionar um novo fluxo OAuth.

O servidor conecta, mas nenhuma ferramenta aparece. Certifique-se de ter concluído a etapa de autenticação — a maioria das ferramentas exige uma sessão válida antes de aparecer. Execute novamente o fluxo de autenticação do seu cliente e atualize a lista de ferramentas. Consulte Ferramentas disponíveis para o conjunto completo.

Seu cliente não consegue conectar de forma alguma. Confirme que a URL é exatamente https://api.xata.tech/mcp e que seu cliente suporta Streamable HTTP. Clientes somente SSE não são suportados.

O servidor não aparece no seu cliente. Verifique a sintaxe do arquivo de configuração MCP do cliente — a estrutura JSON difere entre clientes (mcpServers vs servers vs context_servers, url vs serverUrl) — e verifique os logs do cliente. A maioria dos clientes exige uma reinicialização completa após alterações de configuração.