bling-mcp/README.md

API MCP para integração com Bling

# 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:
   ```bash
   git clone [URL_DO_REPOSITORIO]
   cd bling-mcp
   ```

2. Instale as dependências:
   ```bash
   npm install
   ```

3. Configure as variáveis de ambiente:
   ```bash
   cp .env.example .env
   ```
   Edite o arquivo `.env` e adicione seu token de acesso do Bling.

## Uso

### Executar em modo desenvolvimento

```bash
npm run dev
```

### Compilar e executar em produção

```bash
npm run build
npm start
```

### Testar com MCP CLI

```bash
npx fastmcp dev src/index.ts
```

### Inspecionar com MCP Inspector

```bash
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:**
```json
{
  "pesquisa": "João"
}
```

## Configuração com Claude Desktop

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

```json
{
  "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](https://github.com/punkpeye/fastmcp).

## Licença

MIT