> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pierre.finance/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Comece a usar a Pierre Open Finance API em 5 minutos

## Pré-requisitos

* Conta no Pierre
* API key válida
* Conta bancária ou cartão de crédito conectado

## Passo 1: Obter API Key

<Steps>
  <Step title="Obter API Key">
    Acesse [https://pierre.finance/login](https://pierre.finance/login) e crie uma conta
  </Step>

  <Step title="Conecte sua conta">
    Clique em **"+ Conta"** para conectar sua conta Pierre
  </Step>

  <Step title="Copie sua API Key">
    Acesse [https://pierre.finance/api-key](https://pierre.finance/api-key) e copie sua API Key
  </Step>

  <Step title="Escolher Serviço">
    Decida entre usar as APIs REST ou o servidor MCP baseado no seu caso de uso
  </Step>

  <Step title="Configurar Editor">
    Siga os guias de integração para conectar seu editor preferido
  </Step>

  <Step title="Começar a Usar">
    Teste as APIs e comece a analisar seus dados financeiros
  </Step>
</Steps>

## Passo 2: Testar a API REST

### Teste Básico

```bash theme={null}
curl -X GET 'https://pierre.finance/tools/api/get-accounts' \
  -H 'Authorization: Bearer sk-your-api-key-here'
```

### Teste de Transações

```bash theme={null}
curl -X GET 'https://pierre.finance/tools/api/get-transactions?startDate=2024-01-01&endDate=2024-01-31' \
  -H 'Authorization: Bearer sk-your-api-key-here'
```

## Passo 3: Exemplos de Uso

### REST API

#### JavaScript

```javascript theme={null}
const API_KEY = 'sk-your-api-key-here';
const BASE_URL = 'https://pierre.finance/tools/api';

async function getAccounts() {
  const response = await fetch(`${BASE_URL}/get-accounts`, {
    headers: {
      'Authorization': `Bearer ${API_KEY}`,
      'Content-Type': 'application/json'
    }
  });
  
  return await response.json();
}

// Uso
getAccounts().then(data => {
  console.log('Contas:', data.data);
});
```

#### Python

```python theme={null}
import requests

API_KEY = 'sk-your-api-key-here'
BASE_URL = 'https://pierre.finance/tools/api'

headers = {
    'Authorization': f'Bearer {API_KEY}',
    'Content-Type': 'application/json'
}

def get_accounts():
    response = requests.get(f'{BASE_URL}/get-accounts', headers=headers)
    return response.json()

# Uso
accounts = get_accounts()
print('Contas:', accounts['data'])
```

### MCP Server

### Para Cursor

<Tab title="Cursor (Projeto)">
  Crie um arquivo `.cursor/mcp.json`:

  ```json theme={null}
  {
    "mcpServers": {
      "Pierre Finance": {
        "command": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "https://pierre.finance/mcp",
          "--header",
          "Authorization:${TOKEN}"
        ],
        "env": {
          "TOKEN": "Bearer sk-your-api-key-here"
        }
      }
    }
  }
  ```
</Tab>

<Tab title="Cursor (Global)">
  Crie um arquivo `~/.cursor/mcp.json`:

  ```json theme={null}
  {
    "mcpServers": {
      "Pierre Finance": {
        "command": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "https://pierre.finance/mcp",
          "--header",
          "Authorization:${TOKEN}"
        ],
        "env": {
          "TOKEN": "Bearer sk-your-api-key-here"
        }
      }
    }
  }
  ```
</Tab>

Após configurar o MCP, você pode usar comandos como:

```
"Mostre minhas contas financeiras e saldos atuais"
```

```
"Analise minhas transações do último mês e identifique os maiores gastos"
```

```
"Liste todas as minhas compras parceladas e quando terminam de pagar"
```

### Para Claude Code

Crie um arquivo `~/.cursor/mcp.json`:

```json theme={null}
{
  "mcpServers": {
    "Pierre Finance": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://pierre.finance/mcp",
        "--header",
        "Authorization:${TOKEN}"
      ],
      "env": {
        "TOKEN": "Bearer sk-your-api-key-here"
      }
    }
  }
}
```

### Com Claude Code

```bash theme={null}
# Iniciar Claude Code
claude

# Fazer perguntas
"Analise meus dados financeiros e sugira um plano de economia"
```

## Passo 5: Próximos Passos

<CardGroup cols={2}>
  <Card title="REST API" icon="server" href="/api-services/rest-api">
    Aprenda mais sobre as APIs REST e todos os endpoints disponíveis
  </Card>

  <Card title="MCP Server" icon="plug" href="/api-services/mcp-server">
    Configure editores para acessar dados financeiros diretamente
  </Card>
</CardGroup>

<CardGroup cols={2}>
  <Card title="Cursor Integration" icon="square" href="/editor-integration/cursor">
    Configure o Cursor para análise financeira avançada
  </Card>

  <Card title="Claude Code" icon="code" href="/editor-integration/claude-code">
    Use o Claude Code CLI para análises financeiras
  </Card>
</CardGroup>

## Troubleshooting

### Erro 401 - Autenticação

### Erro 401 - Sem Assinatura

### MCP Não Conecta

1. **Verifique a configuração**: Certifique-se de que o arquivo MCP está correto
2. **Reinicie sua conexão**: Feche e abra a conexão e tente novamente
3. **Teste a conectividade**: Verifique se consegue acessar [https://pierre.finance](https://pierre.finance)

<Note>
  Para dados mais recentes, use o endpoint de sincronização manual quando necessário.
</Note>