Proxenio MCP Server

Servidor MCP para a rede de intenções verificadas Proxenio, permitindo que agentes de IA recuperem correspondências verificadas e aceitem apresentações com controles de confiança herdados.

GitHub

Documentação

Servidor MCP Proxenio

Servidor MCP (Model Context Protocol) para a rede de intenção verificada Proxenio. Permite que agentes de IA executados no Claude Desktop, Cursor, VS Code e outros clientes compatíveis com MCP descubram e interajam com o mecanismo de correspondência profissional da Proxenio.

O Que Ele Faz

Este servidor oferece quatro ferramentas ao seu agente de IA:

Ferramenta	O que faz
`proxenio_discover`	Conheça a plataforma, o modelo de confiança e a API — sem necessidade de autenticação
`proxenio_set_api_key`	Configure sua chave de API Proxenio para autenticação
`proxenio_get_matches`	Leia as correspondências profissionais verificadas do seu principal
`proxenio_accept_match`	Aceite uma solicitação de apresentação, criando um negócio

Seu agente herda o nível de confiança do principal humano. Ele vê exatamente o que o principal vê — mesmo mecanismo de correspondência, mesmas regras, mesmas barreiras de verificação. Sem atalhos.

Pré-requisitos

Node.js 18+
Uma conta Proxenio com e-mail verificado e perfil completo
Uma chave de API gerada em proxenio.ai/agents

Instalação

npx @proxenio-tech/mcp-server

Uso com Claude Desktop

Adicione à configuração do seu Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "proxenio": {
      "command": "npx",
      "args": ["@proxenio-tech/mcp-server"]
    }
  }
}

Depois, no Claude Desktop, você pode dizer:

"O que é Proxenio?"
→ O Claude usa proxenio_discover automaticamente

"Conecte-se à Proxenio com esta chave: prx_YOUR_KEY_HERE_________________"
→ O Claude usa proxenio_set_api_key

"Mostre minhas correspondências profissionais"
→ O Claude usa proxenio_get_matches

"Aceite a apresentação de Maria Georgiou"
→ O Claude usa proxenio_accept_match

Uso com Cursor

Adicione às configurações de MCP do Cursor:

{
  "proxenio": {
    "command": "npx",
    "args": ["@proxenio-tech/mcp-server"]
  }
}

Implantação Remota (HTTP)

Para implantação em múltiplos clientes ou nuvem:

TRANSPORT=http PORT=3001 node dist/index.js

O servidor expõe:

POST /mcp — endpoint do protocolo MCP
GET /health — verificação de integridade

Referência de Ferramentas

`proxenio_discover`

Sem necessidade de autenticação. Retorna informações da plataforma, modelo de confiança, capacidades e links.

`proxenio_set_api_key`

Parâmetro	Tipo	Obrigatório	Descrição
`api_key`	string	Sim	Chave de API completa (36 caracteres, começa com `prx_`)

`proxenio_get_matches`

Parâmetro	Tipo	Padrão	Descrição
`filter_type`	`all\|top\|high\|standard`	`all`	Filtrar por qualidade da correspondência
`filter_status`	`all\|pending\|accepted`	`all`	Filtrar por status
`min_score`	número (40-100)	`40`	Pontuação mínima da correspondência

Retorna: Informações do principal, correspondências com perfis das contrapartes, níveis de confiança, pontuações e status do limite de requisições.

`proxenio_accept_match`

Parâmetro	Tipo	Obrigatório	Descrição
`match_id`	string (UUID)	Sim	ID da correspondência de `proxenio_get_matches`

Retorna: Confirmação, detalhes da contraparte, novo ID do negócio, status do limite de requisições.

Salvaguardas: O principal deve ser a parte receptora. Não é possível aceitar solicitações próprias. A correspondência deve estar ativa com uma apresentação pendente.

Modelo de Confiança

Agentes herdam o nível de confiança do principal humano no momento da solicitação
Níveis de confiança: 0 (Não verificado) → 1 (Iniciante) → 2 (Ativo) → 3 (Confiável) → 4 (Comprovado)
Todas as barreiras de verificação do mecanismo se aplicam — agentes não podem contorná-las
Contrapartes veem o selo de transparência: 🤖 AI Agent active on behalf of [Name]
Apenas humanos podem registrar resultados e confirmar negócios

Limites de Requisições

60 requisições/hora por chave de API
Máximo de 3 chaves por usuário (= 180 requisições/hora no total)
Cabeçalhos de limite de requisições incluídos em todas as respostas

Segurança

Chaves de API nunca são registradas ou armazenadas pelo servidor MCP
Chaves são validadas quanto ao formato antes do uso (prefixo, comprimento)
Toda comunicação usa HTTPS
O servidor MCP atua como passagem — nenhum dado é armazenado em cache

Licença

MIT — Proxenio Technologies Ltd