> For the complete documentation index, see [llms.txt](https://meloqa.gitbook.io/documentacao-meloqa-v2/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://meloqa.gitbook.io/documentacao-meloqa-v2/documentacao/meloqa-mcp.md).

# MeloQA MCP

O **meloQA MCP** é um servidor MCP (*Model Context Protocol*) que expõe a API pública **v1** do meloQA como ferramentas utilizáveis por clientes de IA, como Claude Desktop, Claude Code, Cursor, entre outros.

Com ele, um assistente de IA pode ler e gerenciar diretamente no meloQA: projetos, casos de teste, ciclos, execuções, bugs, vínculos (links) e dados de referência, tudo através de linguagem natural, sem precisar acessar a interface web.

**Status:** pré-lançamento (pre-release)

#### Pré-requisitos

* **Node.js 18+** (o servidor usa `fetch` nativo).
* Um **token de API** do meloQA (disponível em **Menu do usuário → API Tokens**, dentro do app do meloQA).

#### Instalação

O pacote está publicado no npm como [`@meloqa/mcp-server`](https://www.npmjs.com/package/@meloqa/mcp-server).

Não é necessário instalar manualmente, a configuração do cliente MCP (próxima seção) já executa o pacote sob demanda via `npx`, que busca automaticamente a versão mais recente:

bash

```bash
npx -y @meloqa/mcp-server
```

Para instalar globalmente (expõe o binário `meloqa-mcp`):

bash

```bash
npm install -g @meloqa/mcp-server
```