1. O que é o MCP?
O MCP (Model Context Protocol) é um protocolo que permite conectar ferramentas de Inteligência Artificial a sistemas e serviços externos.
Com o MCP Open Finance da TecnoSpeed, você pode conectar sua ferramenta de IA aos recursos disponibilizados pela nossa solução, utilizando comandos em linguagem natural para apoiar o desenvolvimento e a implementação da integração.
A IA poderá consultar as ferramentas disponíveis, orientar a execução de operações e auxiliar na construção e validação do código.
2. Quais ferramentas de IA podem ser utilizadas?
O MCP pode ser conectado a diferentes ferramentas de IA que ofereçam suporte à integração com servidores MCP.
Entre as opções que podem ser utilizadas para os testes estão:
- ChatGPT
- OpenAI Codex
- Claude
- Gemini
Importante: o processo de configuração pode variar de acordo com a ferramenta e sua versão. Os exemplos deste artigo apresentam os procedimentos testados com ChatGPT e Codex.
3. Endereço do MCP
Utilize a URL abaixo para configurar a conexão:
Servidor MCP Open Finance: https://openfinance-mcp-uhxhbf563a-rj.a.run.app/mcp
4. Como configurar no ChatGPT
Etapa 1 – Ativar o modo desenvolvedor
- Acesse as configurações do ChatGPT.
- Entre em Segurança e Login.
- Ative o Modo desenvolvedor.
Etapa 2 – Adicionar o MCP
- Acesse Configurações > Plugins.
- Clique no botão de adicionar (+).
- Selecione a opção para criar um novo conector.
Preencha os campos:
- Nome: OpenFinance TecnoSpeed
- URL: https://openfinance-mcp-uhxhbf563a-rj.a.run.app/mcp
- Autenticação: OAuth
Confirme que deseja continuar e clique em Criar.
Etapa 3 – Autorizar a conexão
- Clique em Conectar.
- Você será direcionado para a página de autenticação do WorkOS (AuthKit).
- Entre com o e-mail autorizado para acessar o serviço.
- Conclua a autorização.
Após a autenticação, o MCP estará conectado ao ChatGPT.
5. Como configurar no OpenAI Codex
A configuração também pode ser realizada utilizando o Codex, inclusive em ambientes de desenvolvimento como o VS Code.
Etapa 1 – Registrar o servidor MCP
Abra o terminal do Codex e execute o comando:
codex mcp add openfinance-tecnospeed --url https://openfinance-mcp-uhxhbf563a-rj.a.run.app/mcp
Esse comando registra o servidor MCP remoto na ferramenta.
Etapa 2 – Realizar a autenticação
Após executar o comando, o Codex identificará o fluxo de autenticação OAuth 2.0.
- O navegador será aberto automaticamente na página de autorização do WorkOS (AuthKit).
- Realize o login com o e-mail autorizado.
- Conclua a autorização solicitada.
Etapa 3 – Verificar a conexão
No terminal, execute:
codex mcp list
O servidor deverá aparecer na listagem com o nome openfinance-tecnospeed, transporte HTTP e autenticação OAuth.
Etapa 4 – Iniciar uma nova sessão
Após concluir a autenticação, abra uma nova sessão do Codex para disponibilizar as ferramentas autenticadas na conversa.
A partir desse momento, você poderá começar a interagir com o MCP por meio de comandos em linguagem natural.
6. Como utilizar o MCP?
Depois de configurar e autenticar a conexão, você poderá solicitar à IA que consulte as ferramentas disponíveis e auxilie nas operações do Open Finance.
Alguns exemplos de solicitações:
- Consulte as ferramentas disponíveis no MCP e explique para que serve cada uma.
- Como posso cadastrar um pagador?
- Quais informações são necessárias para cadastrar uma conta?
- Como consultar os dados de uma conta cadastrada?
- Como gerar um extrato bancário?
- Como consultar as transações de uma conta?
A própria IA poderá orientar quais informações são necessárias para cada operação e solicitar os dados complementares quando necessário.
Atenção: versão de protótipo
O MCP Open Finance disponibilizado neste artigo está em fase de prototipação e testes. Seu objetivo é permitir que os clientes conheçam a tecnologia e experimentem sua utilização com ferramentas de Inteligência Artificial.
Por se tratar de uma versão experimental, poderão ocorrer ajustes, mudanças de comportamento ou instabilidades durante sua utilização.
Comentários
0 comentário
Por favor, entre para comentar.