Bling MCP

Servidor MCP (Model Context Protocol) para integração com a API do Bling, permitindo que assistentes baseados em LLM (Large Language Models) acessem e manipulem dados do Bling.

Requisitos

• Node.js 18 ou superior
• npm ou yarn
• Token de acesso à API do Bling

Instalação

1. Clone o repositório:

   git clone [URL_DO_REPOSITORIO]
   cd bling-mcp

2. Instale as dependências:

   npm install

3. Configure as variáveis de ambiente:

   cp .env.example .env

   Edite o arquivo .env e adicione seu token de acesso do Bling.

Uso

Executar em modo desenvolvimento

npm run dev

Compilar e executar em produção

npm run build
npm start

Testar com MCP CLI

npx fastmcp dev src/index.ts

Inspecionar com MCP Inspector

npx fastmcp inspect src/index.ts

Ferramentas Disponíveis

Lista de Contatos

Obtém a lista de contatos cadastrados no Bling.

Parâmetros:

• pesquisa (opcional): Termo para filtrar os contatos

Exemplo:

{
  "pesquisa": "João"
}

Configuração com Claude Desktop

Adicione a seguinte configuração ao seu arquivo de configuração do Claude Desktop:

{
  "mcpServers": {
    "bling-mcp": {
      "command": "node",
      "args": [
        "dist/index.js"
      ],
      "env": {
        "BLING_TOKEN": "seu_token_aqui"
      }
    }
  }
}

Configuração com FastMCP

Este projeto utiliza o framework FastMCP para criar a integração MCP. Para mais informações, consulte a documentação oficial.

Licença

MIT