# Conectar o servidor MCP do PipeFácil

O servidor Model Context Protocol (MCP) da Match Sales conecta seu agente ao PipeFácil pela conexão remota **Streamable HTTP**. O acesso exige autenticação.

**Endereço do servidor:** [http://mcp.matchsales.com.br/mcp](http://mcp.matchsales.com.br/mcp)

Esse endereço redireciona para `https://mcp.matchsales.com.br/mcp`. As configurações abaixo usam diretamente HTTPS para evitar problemas com redirecionamentos no cliente.

## Autenticação

Use **OAuth** quando seu cliente oferecer esse fluxo. Conclua a autorização na página aberta pelo cliente.

Para clientes que aceitam um token, envie `Authorization: Bearer pf_live_…` no cabeçalho da conexão HTTPS. Crie a chave em **Configurações → Chaves de API**, conforme o [guia de autenticação](/developers/authentication/).

A documentação pública continua disponível em [llms.txt](/llms.txt), nos guias e na [referência da API](/api/).

## Instalar no seu agente

1. Escolha o cliente MCP que você usa e adicione o servidor com uma das configurações abaixo.

2. Reinicie o cliente ou atualize suas conexões MCP e conclua a autenticação.

3. Peça ao agente: **Liste as ferramentas disponíveis no MCP do PipeFácil e explique suas funções.**

### Codex

No terminal, execute:

```bash
codex mcp add pipefacil --url https://mcp.matchsales.com.br/mcp
codex mcp login pipefacil
```

Depois, use `codex mcp list` para conferir o registro.

### Claude Code

No terminal, execute:

```bash
claude mcp add --transport http pipefacil https://mcp.matchsales.com.br/mcp
```

Depois, use `claude mcp list` para conferir o registro.

### Cursor

Adicione o servidor ao arquivo `.cursor/mcp.json` do projeto, ou ao arquivo global de configuração MCP do Cursor:

```json
{
	"mcpServers": {
		"pipefacil": {
			"url": "https://mcp.matchsales.com.br/mcp"
		}
	}
}
```

### Claude Desktop e clientes locais

Clientes que aceitam apenas MCP local podem usar o adaptador [`mcp-remote`](https://developers.cloudflare.com/agents/model-context-protocol/guides/remote-mcp-server/#connect-from-an-mcp-client-via-a-local-proxy). No Claude Desktop, abra **Configurações** > **Desenvolvedor** > **Editar configuração** e adicione:

```json
{
	"mcpServers": {
		"pipefacil": {
			"command": "npx",
			"args": ["-y", "mcp-remote", "https://mcp.matchsales.com.br/mcp"]
		}
	}
}
```

Salve o arquivo e reinicie o Claude Desktop. Se já houver outros servidores, acrescente apenas a entrada `pipefacil` ao objeto `mcpServers` existente.

## Usar as ferramentas

Depois de autenticar, consulte a lista de ferramentas retornada pelo servidor. Use os nomes e parâmetros informados pelo MCP; não assuma que sejam os mesmos da API HTTP.

Antes de preparar uma integração, consulte os [guias para desenvolvedores](/developers/) e a [referência da API](/api/).

Você pode [copiar o prompt de configuração do agente](/agent-setup/). Ele orienta o agente a conectar o MCP, consultar a documentação e conferir o contrato da API.

## Resolver problemas de conexão

- Confira se o endereço termina em `/mcp` e se o cliente aceita **Streamable HTTP**.
- Verifique o registro com `codex mcp list` ou `claude mcp list`, conforme o cliente.
- Se receber `401`, conclua o OAuth ou confira o cabeçalho `Authorization`.
- Se o cliente falhar ao seguir o redirecionamento HTTP, use `https://mcp.matchsales.com.br/mcp`.
- Não abra `/mcp` diretamente no navegador para testar: esse caminho recebe mensagens do protocolo MCP. Use um cliente MCP ou o [MCP Inspector](https://developers.cloudflare.com/agents/model-context-protocol/guides/test-remote-mcp-server/).
- Se o cliente aceitar apenas servidores locais, use o adaptador `mcp-remote` mostrado acima.

Para entender o transporte e a instalação em outros clientes, consulte a [documentação da Cloudflare sobre MCP remoto](https://developers.cloudflare.com/agents/model-context-protocol/guides/remote-mcp-server/).