Integrações

Como usar o servidor MCP do Pumble

3 min de leitura
Milos Milosavljevic

Com o servidor Model Context Protocol (MCP) do Pumble, você pode conectar agentes de IA de terceiros (por exemplo, Claude, Gemini e Codex) ao Pumble e permitir que eles acessem conteúdos para que possam pesquisar mensagens, encontrar informações e realizar ações em seu nome.

Como conectar-se a um servidor MCP #

Para conectar seu assistente de IA ao servidor MCP do Pumble, você precisará criar um complemento (addon) do Pumble e obter as credenciais de lá. Para isso, primeiro você precisará acessar a seção de complementos do Pumble.

  1. Clique nos três pontos ao lado do nome do espaço de trabalho
  2. Passe o mouse sobre Configurações do espaço de trabalho
  3. Selecione Configurar aplicativos
    configure apps

Depois de abrir a página Configurar aplicativos, você pode adicionar seu próprio complemento. Veja como:

  1. Clique em + Criar aplicativo
  2. Selecione Criar do zero
  3. Digite o nome do aplicativo
  4. Digite a descrição
  5. Selecione as permissões de usuário
  6. Selecione as permissões de bot
  7. Clique em Instalar aplicativo
    install app

Após a instalação do aplicativo, certifique-se de copiar a chave do aplicativo, o token do usuário e o token do bot.

O que você pode fazer depois de se conectar ao servidor MCP? #

A lista de ferramentas MCP disponíveis é dinâmica e depende inteiramente dos escopos específicos que você selecionou ao criar um aplicativo.

Estas são todas as ferramentas disponíveis que o servidor MCP do Pumble permite utilizar:

  • add_reaction_to_message
  • add_user_to_channel
  • create_call_link
  • create_channel
  • delete_scheduled_message
  • edit_message
  • fetch_file
  • get_channel_details
  • get_channel_messages
  • get_channels
  • get_latest_messages
  • get_scheduled_messages
  • get_thread_replies
  • get_users
  • get_workspace_info
  • reply_to_message
  • schedule_message
  • search_messages
  • send_message

Além disso, você pode usar os seguintes comandos para se comunicar com o servidor MCP:

  • create-channel-with-initial-users
  • explain-pumble-mcp
  • send-channel-message
  • send-dm-message

Conecte o MCP do Pumble ao Gemini CLI #

Após criar o complemento personalizado, você pode conectá-lo ao seu Gemini CLI. Para isso, cole o código abaixo no seu arquivo settings.json.

{
  "mcpServers": {
    "pumble-mcp": {
      "type": "http",
      "url": "https://mcp.pumble.com/mcp",
      "headers": {
        "token": "user/bot token"
	"x-app-token": "xpat-token"
      }
    }
  }
}

Você também pode fazer isso usando o comando:

claude mcp add pumble-mcp https://mcp.pumble.com/mcp --transport http --header "token: token" --header "x-app-token: xpat-token"
Informações

O token x-app-token/xpat é a chave do aplicativo que você recebe ao criar um aplicativo do zero.

Conecte o Pumble MCP ao Codex CLI #

O servidor MCP do Pumble também pode se conectar ao Codex CLI. Para isso, basta colar o código abaixo no seu arquivo config.toml.

[mcp_servers.pumble-mcp]
transport = "http"
url = "https://mcp.pumble.com/mcp"
http_headers = { "token" = "user/bot token", "x-app-token" = "xpat-token" }

Conecte o Pumble MCP ao Gemini CLI #

Após criar o complemento personalizado, você pode conectá-lo ao seu Gemini CLI. Para isso, cole o código abaixo no seu arquivo settings.json.

{
  "mcpServers": {
    "pumble-mcp": {
      "httpUrl": "https://mcp.pumble.com/mcp",
      "headers": {
        "token": "user/bot token",
        "x-app-token": "xpat-token"
      },
    }
  }
}

 Você também pode fazer isso usando o comando:

gemini mcp add pumble-mcp https://mcp.pumble.com/mcp \
  --transport http \
  --header "token: token
" \
  --header "x-app-token: xpat-token"

Para conectar o Pumble MCP à sua CLI, você precisará da chave do aplicativo e dos tokens de usuário/bot.

Esse artigo foi útil?

Thank you! If you’d like a member of our support team to respond to you, please drop us a note at support@pumble.com