Documentação Técnica

MCP

Descrição

O Model Context Protocol (MCP) é um padrão aberto que permite a comunicação entre modelos de linguagem (LLMs) e serviços externos de forma segura e estruturada. Com a implementação do servidor MCP da BigDataCorp, agora é possível que agentes de diferentes modelos de LLM consumam os datasets da BigDataCorp de maneira simplificada e padronizada.

Isso significa que os desenvolvedores podem construir agentes inteligentes que acessam e utilizam a vasta gama de dados da BigDataCorp para enriquecer suas aplicações, realizar análises complexas e automatizar tarefas que dependem de informações atualizadas e confiáveis. A integração via MCP abstrai a complexidade da comunicação direta com a API, permitindo que os agentes se concentrem em suas tarefas principais.

Conceitos Fundamentais

Model Context Protocol (MCP): É um padrão aberto que estrutura a comunicação entre LLMs e serviços externos (ferramentas). Ele permite que um modelo de linguagem descubra as ferramentas disponíveis, entenda como usá-las e execute chamadas de forma padronizada. Para o desenvolvedor, isso simplifica a integração, pois não é preciso criar um conector específico para cada API.
Agente de IA (AI Agent): É um programa autônomo, alimentado por um LLM, que utiliza um ciclo de raciocínio para resolver um problema. Para interagir com o mundo externo (como buscar dados), o agente utiliza um conjunto de Ferramentas (Tools).
Ferramenta (Tool): No contexto do BigIA, uma ferramenta exposta via MCP corresponde a um ou mais datasets da BigDataCorp. O agente pode invocar essa ferramenta para obter informações e utilizá-las em sua análise ou resposta.

Datasets Disponíveis

A integração via MCP dá acesso a todos os datasets internos da Plataforma de Dados da BigDataCorp, cobrindo informações cadastrais, societárias, financeiras, de risco, compliance e muitas outras. O agente de IA terá a capacidade de descobrir e utilizar os datasets mais adequados para responder às solicitações.

Respostas e Tratamento de Dados

Os resultados das consultas são entregues seguindo a especificação do protocolo MCP. A forma como esses resultados são exibidos ou processados dependerá da implementação do agente — seja em um chatbot, um dashboard interno ou outra ferramenta compatível.

Cobrança

A política de uso e cobrança do MCP foi desenhada para oferecer flexibilidade e previsibilidade.
Custo do Protocolo: Não há cobrança adicional pelo uso do protocolo MCP em si.
Custo dos Dados: A cobrança é baseada apenas nas chamadas aos datasets consumidos pelo agente, seguindo a mesma tabela de preços já praticada para o acesso via Plataforma de Dados.
Atenção: Uma única pergunta ou instrução enviada a um agente de IA pode gerar múltiplas chamadas à diferentes datasets da API para coletar os dados necessários. Monitore seu consumo para evitar exceder limites de forma inesperada.

Configurando um Agente

Para conectar um agente ao servidor MCP da BigDataCorp, é necessário configurar seu agente com a URL do servidor e as credenciais de autenticação. Abaixo está um exemplo de como configurar um agente usando o Agent Development Kit (ADK) do Google em Python, passando o AccessToken e o TokenId nos cabeçalhos da requisição.

from adk.tools import mcp

# Configure o MCP Toolset com a URL do servidor da BigDataCorp
toolset = mcp.load_mcp_toolset(
    'https://app.bigdatacorp.com.br/bigia/mcp',
    headers={
        'AccessToken': 'SEU_ACCESS_TOKEN_AQUI',
        'TokenId': 'SEU_TOKEN_ID_AQUI'
    }
)

# Agora o toolset pode ser adicionado ao seu agente
# e ele estará pronto para usar as ferramentas MCP da BigDataCorp.

Autenticação

A autenticação é realizada através de um AccessToken e um TokenId. Essas credenciais garantem que apenas agentes autorizados possam acessar os dados. Para obter suas credenciais, você pode:

  1. Gerar os tokens através do portal da BigDataCorp em: https://center.bigdatacorp.com.br com usuário e senha devidamente cadastrados.
  2. Gerar tokens utilizando a API de autenticação da BigDataCorp com usuário e senha devidamente cadastrados.

Certifique-se de que suas credenciais sejam mantidas em segurança e renovadas conforme necessário.

Language
Credentials
Click Try It! to start a request and see the response here!