Skip to main content
YourMapSeat

MCP para agentes

Conecte o YourMapSeat ao seu agente.

Use o endpoint MCP para consultar o mapa, acompanhar a atividade e preparar lances com a mesma confirmação explícita do chat.

Streamable HTTP

Use placeholders locais na configuração e mantenha o token fora do repositório.

Endpoint MCP

https://yourmapseat.com/api/mcp

Crie credenciais seguras para conectar Codex, ChatGPT e outros agentes ao mapa do YourMapSeat.

Gerenciar tokens MCP

Acesso autenticado

Content-Type: application/json
Accept: application/json, text/event-stream
Authorization: Bearer <YOUR_ACCESS_TOKEN>

Use placeholders locais na configuração e mantenha o token fora do repositório.

01

Codex

Adicione um servidor MCP remoto nas configurações do Codex e informe o endpoint e o Bearer token localmente.

Exemplo de configuração

[mcp_servers.yourmapseat]
url = "https://yourmapseat.com/api/mcp"
bearer_token_env_var = "YOURMAPSEAT_ACCESS_TOKEN"

Use placeholders locais na configuração e mantenha o token fora do repositório.

02

ChatGPT

Se sua conta oferecer conexão MCP remota, crie um conector nas configurações e use o mesmo endpoint autenticado.

Dados do servidor

  • 1Endpoint MCP: https://yourmapseat.com/api/mcp
  • 2Use o token como Bearer token. Para o Codex, mantenha o segredo em uma variável de ambiente local.
  • 3Use tools/list para descobrir as tools e sempre leia o resultado antes de agir. Dados de preço, ocupação e atividade devem vir das tools ao vivo.

03

O que está disponível

Consulta pública do mapa, estatísticas do usuário, conversas próprias e o fluxo protegido de compra de Regiões.

Use tools/list para descobrir as tools e sempre leia o resultado antes de agir. Dados de preço, ocupação e atividade devem vir das tools ao vivo.

get_world_statisticslist_countriesget_country_statisticslist_country_regionsget_region_detailsget_map_rankingsget_recent_map_activityget_my_ai_usagelist_my_conversationscreate_my_conversationupdate_my_conversationprepare_delete_my_conversationdelete_my_conversationget_purchase_statusprepare_map_purchasestart_map_purchase_checkout

Lances com segurança

Um agente pode preparar um lance, mas não pode comprar silenciosamente.

O endpoint não aceita chaves administrativas, não expõe dados de outros usuários e não confirma ocupação quando apenas o checkout é aberto.

  1. 1Chame prepare_map_purchase e mostre Região, patrocinador, preço e validade.
  2. 2Peça uma confirmação explícita em uma nova mensagem e use o código retornado.
  3. 3Só então chame start_map_purchase_checkout. O pagamento acontece no checkout da Stripe.
Explorar o mapa Abrir o chatGerenciar tokens MCP