Safefy MCP

MCP server oficial da Safefy — integre cobranças PIX, saques, clientes e pagamentos diretamente em qualquer agente de IA compatível com Model Context Protocol.

Como usar no seu agente de IA

Claude (claude.ai)

Configure via claude_desktop_config.json:

{
  "mcpServers": {
    "safefy": {
      "command": "npx",
      "args": ["-y", "@safefypay/safefy-mcp"]
    }
  }
}

v0 (v0.dev)

No chat do v0, clique em "+" → "Add MCP Server" e configure:

{
  "name": "safefy",
  "command": "npx",
  "args": ["-y", "@safefypay/safefy-mcp"]
}

Lovable (lovable.dev)

Acesse Settings → MCP Servers → Add Server e cole:

{
  "name": "safefy",
  "command": "npx",
  "args": ["-y", "@safefypay/safefy-mcp"]
}

Cursor / Windsurf / VS Code

Adicione ao seu mcp.json ou settings.json:

{
  "mcpServers": {
    "safefy": {
      "command": "npx",
      "args": ["-y", "@safefypay/safefy-mcp"]
    }
  }
}

Após adicionar o servidor, peça ao agente para configurar suas credenciais:

"Configure minhas credenciais Safefy: public key pk_..., secret key sk_..."

Gere suas credenciais em: https://app.safefypay.com.br/panel/merchant/api-credentials

O que este servidor expõe

• Assistente de integração:

  • via SDK Node (safefy-sdk-node)

  • via API direta (qualquer linguagem)

• Configuração/autenticação de credenciais (/v1/auth/token)

• Saldo (/v1/balance)

• Transações (/v1/transactions)

• Saques (/v1/cashouts)

• Clientes (/v1/customers)

• Pedidos (/v1/orders)

• Produtos (/v1/products)

• Payment Links públicos (/v1/payment-links)

• Requisição genérica para cobertura total da API (safefy_payment_api_request)

Requisitos

• Node.js 18+

• Credenciais de API Payment (Public Key e Secret Key)

• Gere no painel: https://app.safefypay.com.br/panel/merchant/api-credentials

Instalação local (desenvolvimento)

npm install
npm run build
npm start

Principais tools

• safefy_payment_get_integration_guide

• safefy_payment_list_capabilities

• safefy_payment_configure_credentials

• safefy_payment_get_configuration

• safefy_payment_authenticate

• safefy_payment_api_request

• safefy_payment_get_balance

• safefy_payment_create_transaction

• safefy_payment_list_transactions

• safefy_payment_get_transaction

• safefy_payment_simulate_transaction

• safefy_payment_resend_transaction_webhook

• safefy_payment_create_cashout

• safefy_payment_list_cashouts

• safefy_payment_get_cashout

• safefy_payment_cancel_cashout

• safefy_payment_simulate_cashout

• safefy_payment_create_customer

• safefy_payment_list_customers

• safefy_payment_get_customer

• safefy_payment_update_customer

• safefy_payment_create_order

• safefy_payment_list_orders

• safefy_payment_get_order

• safefy_payment_list_products

• safefy_payment_get_product

• safefy_payment_get_payment_link

• safefy_payment_start_payment_link

• safefy_payment_get_payment_link_status

Cobertura total da API Payment

Quando uma operação ainda não tiver tool dedicada, use safefy_payment_api_request.

Exemplo:

{
	"path": "/v1/transactions",
	"method": "GET",
	"requireAuth": true,
	"query": {
		"page": 1,
		"pageSize": 20
	}
}

Skill no .github

O conteúdo de mcp-builder foi espelhado para .github/skills/mcp-builder para uso como skill de apoio no projeto.