Open MCP Client: Automatize Tarefas com Servidores MCP e Composio.dev

Introdução aos Servidores e Clientes MCP

No universo da automação e dos agentes de Inteligência Artificial (IA), os servidores MCP (Managed Composio Protocol) estão ganhando destaque. Esses servidores oferecem ferramentas que podem ser utilizadas por agentes de IA para executar uma variedade de tarefas. Uma parte crucial desse ecossistema são os clientes MCP, como o Cursor e o Windsurf, que fornecem um agente para interagir com as ferramentas disponibilizadas pelos servidores MCP.

Embora clientes como Cursor e Windsurf sejam excelentes para casos de uso específicos, como IDEs de codificação, surge a necessidade de um cliente MCP separado quando se deseja gerenciar tarefas não relacionadas à programação, mas ainda utilizando o poder dos servidores MCP. É aqui que entra o Open MCP Client.

O que é o Open MCP Client?

O Open MCP Client é uma aplicação de código aberto que também fornece um agente de IA, permitindo uma automação robusta de tarefas diversas. Ele se destaca pela capacidade de integrar diferentes servidores MCP, centralizando a gestão de automações em um único local.

Explorando o Composio.dev: Uma Biblioteca de Servidores MCP Gerenciados

Para facilitar a utilização de servidores MCP, o Composio.dev surge como uma excelente biblioteca com mais de 100 servidores MCP gerenciados. Uma de suas grandes vantagens é a autenticação embutida, eliminando a necessidade de lidar manualmente com chaves de API e variáveis de ambiente. Basta colar o link SSE (Server-Sent Events) fornecido pelo Composio.dev, e a autenticação é cuidada pela plataforma.

Utilizando o Open MCP Client na Prática

O Open MCP Client, que pode ser acessado através da versão hospedada em open-mcp-client.vercel.app ou instalado localmente a partir de seu repositório no GitHub, permite adicionar servidores MCP de duas formas principais:

  • Standard I/O: Para servidores que rodam localmente, onde você especifica o comando e seus argumentos (por exemplo, npx <caminho_ou_pacote>).
  • SSE (Server-Sent Events): Ideal para servidores remotos, como os oferecidos pelo Composio.dev, onde você simplesmente insere a URL SSE fornecida.

Uma vez adicionado um servidor, uma interface de chat permite interagir com o agente. Por exemplo, ao adicionar o servidor MCP do Hacker News (disponível via Composio.dev), você pode perguntar "Quais as últimas notícias do YC?" e o agente utilizará a ferramenta HACKERNEWS_GET_LATEST_POSTS para fornecer os destaques.

Integrando com o Composio.dev

O Composio.dev oferece uma vasta gama de servidores MCP gerenciados, como Gmail, Google Drive, Notion e Google Meet. A beleza dessa integração é que você não precisa rodar esses servidores localmente nem se preocupar com a configuração de autenticação. O Composio.dev lida com isso, fornecendo uma URL SSE segura para cada serviço.

Autenticação Simplificada com Composio.dev

O Composio.dev suporta dois métodos principais de autenticação, ambos projetados para serem automatizados por agentes de IA:

  1. Autenticação OAuth:
    1. O agente verifica a conexão.
    2. Se não houver conexão ativa, o agente solicita a iniciação da conexão.
    3. O sistema fornece um link para completar a autenticação OAuth no navegador.
    4. Uma vez autenticado, o agente pode executar as ações autorizadas.
  2. Autenticação por Chave de API:
    1. O agente verifica a conexão.
    2. Se não houver conexão ativa, o agente solicita a iniciação da conexão.
    3. O LLM (Large Language Model) inicia a conexão e solicita a chave de API.
    4. Você cola a chave de API na interface de chat.
    5. Após a autenticação bem-sucedida, a ferramenta está pronta para uso.

Essa abordagem elimina a necessidade de inserir manualmente variáveis de ambiente ou chaves de API em arquivos de configuração, tornando o processo mais seguro e prático.

Exemplo Prático: Conectando o Google Tasks

Para ilustrar, ao adicionar o servidor MCP do Google Tasks através do Composio.dev ao Open MCP Client:

  1. No Composio.dev, gere a URL SSE para o Google Tasks.
  2. No Open MCP Client, adicione um novo servidor, selecione SSE, nomeie-o (ex: "G-mail MCP" ou "Google Tasks MCP") e cole a URL.
  3. Na interface de chat, pergunte se a ferramenta Google Tasks está conectada.
  4. O agente usará a ferramenta GOOGLETASKS_CHECK_ACTIVE_CONNECTION. Se não estiver conectado, ele perguntará se você deseja iniciar a conexão.
  5. Ao confirmar, o agente usará GOOGLETASKS_INITIATE_CONNECTION e fornecerá um link para autenticação OAuth.
  6. Após autenticar no navegador, o agente confirmará que a conexão está ativa.
  7. Agora você pode, por exemplo, pedir para listar todas as suas tarefas (GOOGLETASKS_LIST_TASK_LISTS seguido por GOOGLETASKS_LIST_TASKS para cada lista), e o agente as exibirá na interface.

Instalação Local do Open MCP Client (Opcional)

Para aqueles que preferem rodar o Open MCP Client localmente:

  1. Clone o repositório: git clone https://github.com/CopilotKit/open-mcp-client.git
  2. Navegue para o diretório e configure as variáveis de ambiente: Crie um arquivo .env na raiz com sua LANGSMITH_API_KEY.
  3. Dentro da pasta agent, crie outro arquivo .env com sua OPENAI_API_KEY e novamente a LANGSMITH_API_KEY. A chave LangSmith pode ser obtida no site da LangSmith.
  4. Certifique-se de ter o PNPM instalado.
  5. Execute os comandos para rodar o frontend e o agente separadamente (para melhor depuração) ou juntos:
    • Terminal 1 (Frontend): pnpm run dev-frontend
    • Terminal 2 (Agente): pnpm run dev-agent (certifique-se de ter o Poetry instalado e, se encontrar erros, pode ser necessário navegar para a pasta agent, rodar poetry lock e poetry install, e depois tentar pnpm run dev-agent novamente na raiz).
    • Alternativamente, para rodar ambos: pnpm run dev
  6. Acesse http://localhost:3000 no seu navegador.

Embora a execução local possa apresentar alguns desafios de configuração e desempenho, ela oferece maior controle para desenvolvedores.

O Futuro Promissor dos Clientes MCP

O Open MCP Client e plataformas como o Composio.dev representam um avanço significativo na forma como interagimos com agentes de IA e automatizamos tarefas. A capacidade de integrar diversas ferramentas de maneira segura e simplificada abre um leque de possibilidades.

Imagine agentes de IA que podem gerenciar seus e-mails, agendar reuniões, organizar seus arquivos no Google Drive, interagir no Discord e muito mais, tudo a partir de um único cliente MCP. Embora ainda existam arestas a serem polidas, especialmente na interface do usuário e na robustez do agente do Open MCP Client em comparação com soluções mais maduras como Cursor, o potencial é imenso. À medida que essas ferramentas evoluem, podemos esperar assistentes pessoais de IA cada vez mais poderosos e integrados ao nosso cotidiano digital.