docsales-mcp

Summary

DocSales MCP Server - Servidor MCP para integração com a API DocSales

DocSales API

A DocSales disponibiliza uma interface de programação web, no modelo REST. Por meio dessa interface, possível conversar com o sistema da DocSales, criando, verificando documentos e realizando a sincronização com os seus sistemas.

O endereço base de comunicação web.docsales.com, acompanhado sempre do protocolo seguro https:// como prefixo. As versões da API são agrupadas por diretório, sufixadas ao endereço base (https://web.docsales.com/api/v1).

Autenticação: A Autenticação na DocSales é feita através da utilização de um token de API. Esta token serve para que o sistema identifique a sua conta, e concede permissões para que o sistema se comunique com a DocSales em nome da conta em questão.

A maneira de se autenticar, é utilizando HTTP Bearer Token Auth. Ao efetuar o login em sua conta da DocSales, você pode encontrar o token no endereço https://web.docsales.com/integrations.

WebHooks

Na plataforma DocSales existem as seguintes configurações para Webhooks (quando disponível no plano contratado):

• URL - Define o ponto de acesso para o envio das informações do Webhook
• Versão - Define a versão do Webhook (v1 e v2 disponíveis)
• Eventos - Define quais eventos serão enviados:
  • Documento assinado
  • Documento rejeitado
  • Documento cancelado
  • Documento Lido

Table of Contents

• docsales-mcp
  • Installation
  • Testando a Instalação

Installation

Install the MCP server as a Desktop Extension using the pre-built mcp-server.dxt file:

Simply drag and drop the mcp-server.dxt file onto Claude Desktop to install the extension.

The DXT package includes the MCP server and all necessary configuration. Once installed, the server will be available without additional setup.

[!NOTE] DXT (Desktop Extensions) provide a streamlined way to package and distribute MCP servers. Learn more about Desktop Extensions.

Or manually:

1. Open Cursor Settings
2. Select Tools and Integrations
3. Select New MCP Server
4. If the configuration file is empty paste the following JSON into the MCP Server Configuration:

{
  "mcpServers": {
    "DocsalesMcpSDK": {
      "command": "npx",
      "args": [
        "mcp",
        "start",
        "--bearer",
        "..."
      ]
    }
  }
}

claude mcp add mcp npx mcp start -- --bearer ...

Refer to Official Windsurf documentation for latest information

1. Open Windsurf Settings
2. Select Cascade on left side menu
3. Click on Manage MCPs. (To Manage MCPs you should be signed in with a Windsurf Account)
4. Click on View raw config to open up the mcp configuration file.
5. If the configuration file is empty paste the full json

{
  "mcpServers": {
    "DocsalesMcpSDK": {
      "command": "npx",
      "args": [
        "mcp",
        "start",
        "--bearer",
        "..."
      ]
    }
  }
}

Refer to Official VS Code documentation for latest information

1. Open Command Palette
2. Search and open MCP: Open User Configuration. This should open mcp.json file
3. If the configuration file is empty paste the full json

{
  "mcpServers": {
    "DocsalesMcpSDK": {
      "command": "npx",
      "args": [
        "mcp",
        "start",
        "--bearer",
        "..."
      ]
    }
  }
}

You need to do the following

1. Open claude Desktop
2. Open left hand side pane, then click on your Username
3. Go to Settings
4. Go to Developer tab (on the left hand side)
5. Click on Edit Config Paste the following config in the configuration

{
  "mcpServers": {
    "DocsalesMcpSDK": {
      "command": "npx",
      "args": [
        "mcp",
        "start",
        "--bearer",
        "..."
      ]
    }
  }
}

npx mcp start --bearer ...

For a full list of server arguments, run:

npx mcp --help

Testando a Instalação

Execute o script de teste para verificar se tudo está funcionando:

# Testar o servidor MCP do DocSales
./test-mcp-servers.sh

Arquivos de Configuração

• combined-mcp-config.json - Configuração do DocSales MCP