Guia de configuração do MCP

Este guia orienta você na conexão do seu assistente de IA ao servidor MCP do Pipe2.ai.

Pré-requisitos

• Uma conta do Pipe2.ai com créditos
• Um token de acesso pessoal (PAT) — consulte Autenticação

Claude Desktop

1. Gere um token de acesso pessoal no seu painel do Pipe2.ai, em Configurações > Chaves de API > Tokens de acesso pessoal.

2. Adicione o servidor MCP via CLI:

   claude mcp add pipe2ai -- \
     https://mcp.pipe2.ai/mcp \
     --header "Authorization: Bearer YOUR_TOKEN"

   Ou adicione-o manualmente ao arquivo de configuração do Claude Desktop:

   macOS

   // ~/Library/Application Support/Claude/claude_desktop_config.json
   {
     "mcpServers": {
       "pipe2ai": {
         "url": "https://mcp.pipe2.ai/mcp",
         "headers": {
           "Authorization": "Bearer YOUR_TOKEN"
         }
       }
     }
   }

   Windows

   %APPDATA%\Claude\claude_desktop_config.json

   {
     "mcpServers": {
       "pipe2ai": {
         "url": "https://mcp.pipe2.ai/mcp",
         "headers": {
           "Authorization": "Bearer YOUR_TOKEN"
         }
       }
     }
   }

   Linux

   ~/.config/claude/claude_desktop_config.json

   {
     "mcpServers": {
       "pipe2ai": {
         "url": "https://mcp.pipe2.ai/mcp",
         "headers": {
           "Authorization": "Bearer YOUR_TOKEN"
         }
       }
     }
   }

3. Reinicie o Claude Desktop para carregar a nova configuração.

4. Verifique a conexão perguntando ao Claude: “Liste meus pipelines disponíveis do Pipe2.ai.”

Claude Code (CLI)

1. Adicione o servidor usando a CLI:

   claude mcp add pipe2ai \
     --transport http \
     --url https://mcp.pipe2.ai/mcp \
     --header "Authorization: Bearer YOUR_TOKEN"

2. Inicie uma sessão e peça ao Claude Code para interagir com seus pipelines:

   claude "List all available Pipe2.ai pipelines"

Cursor

1. Abra as Configurações do Cursor (Cmd/Ctrl + Shift + P > “Cursor Settings”).

2. Navegue até a seção MCP.

3. Adicione um novo servidor MCP com estas configurações:

   • Nome: pipe2ai
   • URL: https://mcp.pipe2.ai/mcp
   • Headers: Authorization: Bearer YOUR_TOKEN

4. Reinicie o Cursor e use as ferramentas do Pipe2.ai no seu chat de IA.

Outros clientes MCP

Qualquer cliente compatível com MCP pode se conectar ao Pipe2.ai. A configuração principal:

Configuração	Valor
URL do servidor	https://mcp.pipe2.ai/mcp
Transporte	Streamable HTTP (preferido) ou SSE (https://mcp.pipe2.ai/sse/)
Header de autenticação	Authorization: Bearer YOUR_TOKEN

Nota

Para o fluxo OAuth 2.1 em vez de tokens de acesso pessoal, consulte a página de Autenticação. O OAuth é suportado por clientes que implementam a especificação MCP OAuth.

Verificando sua conexão

Depois de conectado, experimente estes comandos com seu assistente de IA:

1. “Liste os pipelines disponíveis” — deve retornar todos os pipelines ativos com descrições
2. “Verifique meu saldo de créditos” — deve mostrar seus créditos atuais
3. “Mostre meus assets recentes” — deve listar suas imagens e vídeos gerados

Se algum deles falhar, verifique seu token e a conectividade de rede. Consulte Autenticação para solucionar problemas com o token.