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 ↗

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.

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

Instalar no seu agente

Escolha o cliente MCP que você usa e adicione o servidor com uma das configurações abaixo.
Reinicie o cliente ou atualize suas conexões MCP e conclua a autenticação.
Peça ao agente: Liste as ferramentas disponíveis no MCP do PipeFácil e explique suas funções.

Codex

No terminal, execute:

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:

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:

{
	"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 ↗. No Claude Desktop, abra Configurações > Desenvolvedor > Editar configuração e adicione:

{
	"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 e a referência da API.

Você pode copiar o prompt de configuração do agente. 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 ↗.
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 ↗.