<< docs .criar conta

[docs] mcp · v1.4.0

MCP da s6xpay

O MCP liga a Claude, o Cursor e outros clientes à conta, com as permissões que você autoriza.

[api rest][webhooks][mcp]

Introdução

O MCP oficial da s6xpay expõe dezenas de ferramentas para IAs (Claude, Cursor, Grok) operarem checkout, produtos, páginas, quiz, CRM, analytics e biblioteca de componentes — sempre no escopo do perfil MCP que você autorizar.

  • OAuth PKCE em mcp.s6xpay.com — sem colar token manual (recomendado).
  • Refs opacos (slug) em vez de IDs numéricos — checkout_ref, product_ref, quiz_ref.
  • Escritas auditadas em /v2/mcp; skills limitam abilities por token.
  • Transporte Streamable HTTP em POST /mcp com Bearer Sanctum após OAuth.
ItemEndereço
Servidorhttps://mcp.s6xpay.com
Endpoint MCPhttps://mcp.s6xpay.com/mcp
Healthhttps://mcp.s6xpay.com/health

Conectar o seu cliente

Claude Web (recomendado)

claude_web
Settings → Conectores → Adicionar conector personalizado
Nome: s6xpay
URL: https://mcp.s6xpay.com/mcp
→ Clique em Vincular e entre com Project Six
(Sem token manual — OAuth automático)

Claude Code / Desktop

claude
claude mcp add --transport http s6xpay https://mcp.s6xpay.com/mcp
# Depois: /mcp → Authenticate (OAuth)

# Ou Bearer manual (avançado):
claude mcp add --transport http s6xpay https://mcp.s6xpay.com/mcp \
  --header "Authorization: Bearer {{TOKEN}}"

// Baixe skills em /api-app/mcp/agent-skills/export.zip e instale em Settings → Features, ou use MCP + resource s6xpay://skills/context.

Cursor

cursor
{
  "mcpServers": {
    "s6xpay": {
      "url": "https://mcp.s6xpay.com/mcp"
    }
  }
}

→ Settings → MCP → Connect (OAuth)

# Bearer manual (avançado):
"headers": { "Authorization": "Bearer {{TOKEN}}" }

// Extraia s6xpay-agent-skills.zip em ~/.cursor/skills/ (cada pasta contem SKILL.md). MCP e Agent Skills complementam-se.

Grok (grok.com)

grok
grok.com → Conectores → Novo conector → Personalizado
Nome: s6xpay
URL: https://mcp.s6xpay.com/mcp
→ Vincular / OAuth (PKCE) e entrar com Project Six
Perfil MCP criado em https://s6xpay.com/v2/mcp

OpenCode

opencode
{
  "mcpServers": {
    "s6xpay": {
      "url": "https://mcp.s6xpay.com/mcp",
      "headers": {
        "Authorization": "Bearer {{TOKEN}}"
      }
    }
  }
}

// Copie pastas para ~/.config/opencode/skills/ ou .agents/skills/ no projeto.

OAuth

ItemValor
issuer_urlhttps://mcp.s6xpay.com/oauth/mcp
resource_urlhttps://mcp.s6xpay.com/mcp
authorization_endpointhttps://mcp.s6xpay.com/oauth/mcp/authorize
token_endpointhttps://mcp.s6xpay.com/oauth/mcp/token
registration_endpointhttps://mcp.s6xpay.com/oauth/mcp/register
protected_resource_metadatahttps://mcp.s6xpay.com/.well-known/oauth-protected-resource/mcp
scopesmcp

Ferramentas

Checkout & layout

Schema, layout JSON, preview e restauração de versão.

FerramentaO que fazPermissão
checkout-schemaSchema e versões do layout.write_checkout_layout
checkout-layoutAtualiza layout (sanitizado).write_checkout_layout
checkout-previewURL de preview temporária.write_checkout_layout
checkout-restoreRestaura versão anterior.write_checkout_layout
funnel-analysisAbandono por etapa.read_analytics
checkout-performanceMétricas agregadas.read_analytics

Produtos

CRUD e configurações de produto.

FerramentaO que fazPermissão
list-productsLista produtos da conta.read_products
get-productDetalhe por product_ref.read_products
create-productCria produto.write_products
update-productAtualiza produto, capa, order bump e domínio do checkout.write_product_settings

Pixels & rastreamento

Vincular pixels ao checkout.

FerramentaO que fazPermissão
list-pixelsPixels da conta.read_products
checkout-pixelsPixels do checkout.read_products
link-checkout-pixelsAssocia pixel ao checkout.write_product_settings

Páginas & design

Landing, ofertas, biblioteca HeroUI.

FerramentaO que fazPermissão
list-pagesLista páginas.write_pages
page-layoutAtualiza árvore de componentes.write_pages
list-componentsCatálogo de componentes.write_pages
design-playbookGuia de design para a IA.write_pages

Quiz

Funil quiz, publicação e domínios.

FerramentaO que fazPermissão
list-quizzesLista quizzes.write_quiz_flow
sync-quizSincroniza fluxo.write_quiz_flow
publish-quizPublica quiz.write_quiz_flow
quiz-domainsDomínios do quiz.write_quiz_flow
link-checkout-domainVincula domínio ao checkout.write_quiz_flow
quiz-statusHTTP da URL pública (sem abrir quiz.*).write_quiz_flow

Pedidos & CRM

Pedidos, CRM WhatsApp (quando habilitado).

FerramentaO que fazPermissão
list-ordersLista pedidos.read_orders
order-summaryResumo de pedido.read_orders
list-crmFunis CRM.crm_whatsapp
crm-capabilitiesO que o CRM pode fazer.crm_whatsapp

Referências (refs)

RefO que é
checkout_refSlug do checkout (ex.: 63WXotQF-LFPUINDC), nunca ID interno.
product_refSlug do produto (ex.: 63WXotQF).
page_refSlug da página de oferta / obrigado.
quiz_refIdentificador público do quiz.

Resolução de problemas

Grok: “Conectado” mas zero ferramentas

OAuth pode concluir (token 200) enquanto o cliente não envia Authorization: Bearer no POST /mcp (401 nos logs). Reconecte o conector, escolha um perfil MCP com skills salvas (não mcp:pending). Se persistir, use Claude/Cursor ou configure no painel até o cliente Grok enviar o Bearer.

IA abrindo o painel /v2 em vez de MCP

O assistente não deve substituir MCP por login no painel. Ferramentas de escrita vêm do endpoint MCP com token OAuth; o painel é para humanos ou quando o conector não lista tools.

Perfil MCP pendente

Tokens sem skills configuradas ficam com ability mcp:pending e não passam no OAuth. Em /v2/mcp, abra o perfil, marque funcionalidades e salve antes de autorizar de novo.