Integração do Protocolo de Contexto de Modelo (MCP)

A API Travel Impact Model (TIM) é compatível com o Protocolo de Contexto de Modelo (MCP), um padrão aberto criado para que agentes de IA e modelos de linguagem grandes (LLMs) interajam com APIs e ferramentas. Ao usar o endpoint do MCP, os agentes de IA podem descobrir e usar dinamicamente os recursos da API TIM para calcular as emissões de voos.

Para mais informações sobre o protocolo, consulte a Especificação do Protocolo de Contexto de Modelo.

Endpoint

O endpoint do MCP para a API Travel Impact Model é:

https://travelimpactmodel.googleapis.com/mcp

Todas as interações do MCP são realizadas enviando solicitações POST JSON-RPC 2.0 para esse endpoint.

Autenticação

O endpoint do MCP usa os mesmos métodos de autenticação da API padrão do modelo de impacto de viagens. Você precisa fornecer uma chave de API válida do seu projeto na nuvem do Google, garantindo que a "API Travel Impact Model" esteja ativada.

Métodos principais do MCP

As interações com o endpoint do MCP usam principalmente dois métodos:

  • tools/list: descobre as ferramentas disponíveis, as descrições delas e os esquemas JSON de entrada/saída.
  • tools/call: executa uma ferramenta específica com os argumentos fornecidos.

Ferramentas disponíveis

As seguintes funcionalidades são expostas como ferramentas:

  • compute_flight_emissions: recupera as emissões detalhadas de voos específicos.
  • compute_typical_flight_emissions: recupera as emissões típicas entre pares de aeroportos, sem exigir detalhes específicos do voo.
  • compute_scope3_flight_emissions: recupera as emissões de voos históricos, adequadas para relatórios de Escopo 3.

Os esquemas exatos para entradas e saídas são fornecidos na resposta tools/list.

Integrar com agentes de IA

Configure aplicativos de IA conhecidos usando estas instruções. Substitua YOUR_API_KEY pela sua chave de API do Travel Impact Model.

CLI do Gemini

Para configurar a CLI do Gemini, siga estas etapas:

  1. Crie um arquivo de extensão em ~/.gemini/extensions/travel-impact-model/gemini-extension.json.

  2. Salve o conteúdo a seguir no arquivo:

    {
  "name": "travel-impact-model",
  "version": "3.0.0",
  "mcpServers": {
    "travel-impact-model": {
      "httpUrl": "https://travelimpactmodel.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

  3. Execute gemini no terminal para iniciar a CLI do Gemini.

  4. Execute /mcp list para verificar se o servidor travel-impact-model está configurado e se as ferramentas estão disponíveis.

Antigravity

Para configurar o Antigravity para usar o servidor MCP:

  1. No Antigravity, clique no menu Outras opções no painel do agente > Servidores MCP > Gerenciar servidores MCP.

  2. Na parte de cima do painel "Gerenciar servidores MCP" que aparece, clique em Ver configuração bruta para editar o arquivo mcp_config.json:

    {
  "mcpServers": {
    "TravelImpactModel": {
      "serverUrl": "https://travelimpactmodel.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

  3. Volte para Gerenciar servidores MCP e clique em Atualizar.

Exemplos de interações

Depois de configurada, você pode interagir com a API TIM usando linguagem natural pelo seu agente de IA.

Usuário:quais são as emissões do voo LX 52 de Zurique para Boston?

Agente:as emissões de carbono projetadas por passageiro para o voo LX 52 da Swiss International Air Lines de Zurique (ZRH) para Boston (BOS) hoje, 25 de março de 2026, são as seguintes:

  • Econômico:354,10 kg de CO₂e
  • Econômica premium:531,14 kg de CO₂e
  • Empresa:1.416,38 kg de CO₂e
  • Primeiro:1.770,48 kg de CO₂e

Este voo tem um impacto moderado projetado de rastros de condensação.

Usuário:quais são as emissões típicas de Zurique para Boston?

Agente:as emissões de carbono típicas por passageiro em um voo de Zurique (ZRH) para Boston (BOS) são as seguintes:

  • Economia: 415,41 kg de CO₂e
  • Econômica premium:582,00 kg de CO₂e
  • Empresarial:1.473,95 kg de CO2e
  • Primeiro:1.817,35 kg de CO₂e