Standard Metrics MCP Server

Conecta-se à API do Standard Metrics para permitir análise com IA de dados de portfólio de capital de risco.

Documentação

Standard Metrics MCP Server

[!WARNING] DEPRECADO: Nosso servidor MCP local está obsoleto. Use nossa nova configuração MCP hospedada: Guia de Configuração MCP

Um servidor Model Context Protocol (MCP) que conecta o Claude Desktop e outros clientes compatíveis com MCP à API do Standard Metrics, permitindo análise com IA dos dados do seu portfólio de venture capital.

O Que Este Servidor Faz

Este servidor MCP permite que o Claude acesse diretamente seus dados do Standard Metrics para:

Analisar Desempenho do Portfólio: Obtenha visões gerais abrangentes de todas as empresas do seu portfólio
Consultar Métricas Financeiras: Acesse receita, crescimento, taxa de queima e outras métricas-chave
Pesquisar e Filtrar: Encontre empresas por setor, desempenho ou critérios personalizados
Gerar Relatórios: Crie resumos financeiros detalhados e análises de desempenho
Acompanhar Tendências: Monitore métricas ao longo do tempo com análise de dados históricos

Instalação

1. Obtenha Suas Credenciais OAuth2 do Standard Metrics

Faça login na sua conta do Standard Metrics
No menu à esquerda, clique em Configurações
Clique em Configurações do Desenvolvedor
Clique em "Adicionar Aplicativo" no canto superior direito
Preencha o nome e a descrição do aplicativo
Clique em "Criar Aplicativo"
Copie seu Client ID e Client Secret e armazene-os com segurança (você não poderá ver o segredo novamente!)

2. Instale via Claude Desktop

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

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

Primeiro, encontre o caminho do seu uvx executando which uvx no terminal e use esse caminho na configuração:

{
  "mcpServers": {
    "standard-metrics": {
      "command": "/path/to/uvx",
      "args": ["smx-mcp"],
      "env": {
        "SMX_CLIENT_ID": "your_client_id_here",
        "SMX_CLIENT_SECRET": "your_client_secret_here"
      }
    }
  }
}

Substitua /path/to/uvx pelo resultado de which uvx e substitua your_client_id_here e your_client_secret_here pelas suas credenciais OAuth2 reais.

Pré-requisitos

Se você ainda não o instalou, precisará instalar o gerenciador de pacotes Python uv primeiro:

macOS/Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

3. Reinicie o Claude Desktop

Feche e reabra o Claude Desktop. Você deve ver "Standard Metrics" aparecer nas suas conexões MCP.

Exemplos de Uso

Depois de instalado, você pode pedir ao Claude para analisar os dados do seu portfólio:

Visão Geral do Portfólio

Show me a summary of my entire portfolio performance

Análise de Empresa

What are the key metrics for Acme Corp over the last 12 months?

Comparação por Setor

Compare the revenue growth of all my SaaS companies

Análise Financeira Detalhada

Create a financial summary for company ID abc123 including burn rate and runway

Consultas Personalizadas

Find all companies with revenue growth above 50% and show their latest metrics

Dados Disponíveis

O servidor MCP fornece acesso a:

Tipo de Dado	Descrição
Empresas	Informações e detalhes das empresas do portfólio
Métricas Financeiras	Receita, despesas, taxas de crescimento, taxa de queima
Orçamentos e Previsões	Dados de orçamento e projeções financeiras
Colunas Personalizadas	Colunas de dados personalizadas da sua empresa
Documentos	Relatórios enviados e documentos financeiros
Notas	Notas internas e comentários
Dados de Fundos	Informações em nível de fundo
Solicitações de Informações	Solicitações de coleta de dados enviadas às empresas
Relatórios de Informações	Respostas às solicitações de informações
Usuários	Membros da equipe da sua empresa

Métodos Alternativos de Instalação

Usando Docker

{
  "mcpServers": {
    "standard-metrics": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "SMX_CLIENT_ID=your_client_id_here",
        "-e", "SMX_CLIENT_SECRET=your_client_secret_here",
        "-p", "8000:8000",
        "quaestorapp/smx-mcp:latest"
      ]
    }
  }
}

Desenvolvimento Local

git clone https://github.com/Quaestor-Technologies/smx-mcp
cd smx-mcp
uv sync

Em seguida, use o caminho local na sua configuração do Claude Desktop:

{
  "mcpServers": {
    "standard-metrics": {
      "command": "uv",
      "args": ["run", "python", "-m", "src.server"],
      "env": {
        "SMX_CLIENT_ID": "your_client_id_here",
        "SMX_CLIENT_SECRET": "your_client_secret_here"
      }
    }
  }
}

Executando com Docker

1. Execute com a Imagem Hospedada (Recomendado)

Você pode usar a imagem pré-construída do Docker Hub para a configuração mais rápida:

docker run --rm -it \
  -e SMX_CLIENT_ID=your_client_id_here \
  -e SMX_CLIENT_SECRET=your_client_secret_here \
  -p 8000:8000 \
  quaestorapp/smx-mcp:latest

Substitua your_client_id_here e your_client_secret_here pelas suas credenciais OAuth2 reais do Standard Metrics.
O servidor estará disponível em http://localhost:8000.

2. Construa e Execute Localmente

Se você quiser construir a imagem você mesmo (para desenvolvimento ou personalização):

# Build the Docker image
docker build -t smx-mcp .

# Run the container
docker run --rm -it \
  -e SMX_CLIENT_ID=your_client_id_here \
  -e SMX_CLIENT_SECRET=your_client_secret_here \
  -p 8000:8000 \
  smx-mcp

Novamente, substitua as variáveis de ambiente pelas suas credenciais.

3. Usando Docker no Claude Desktop

Adicione isto à sua configuração MCP do Claude Desktop para usar a imagem Docker:

{
  "mcpServers": {
    "standard-metrics": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "SMX_CLIENT_ID=your_client_id_here",
        "-e", "SMX_CLIENT_SECRET=your_client_secret_here",
        "-p", "8000:8000",
        "quaestorapp/smx-mcp:latest"
      ]
    }
  }
}

Dica:

A imagem hospedada é atualizada automaticamente a cada lançamento.
Para desenvolvimento local, você pode montar seu código no contêiner com -v $(pwd)/src:/app/src se quiser recarregamento de código ao vivo.

Solução de Problemas

Erro "Falha na Conexão"

Verifique se seu Client ID e Client Secret estão corretos
Certifique-se de que seu aplicativo OAuth2 está ativo no Standard Metrics
Verifique se o Claude Desktop foi reiniciado após a configuração

Erro "Nenhum Dado Encontrado"

Confirme se sua conta do Standard Metrics tem dados de portfólio
Verifique se seu aplicativo OAuth2 tem as permissões necessárias
Tente uma consulta mais simples primeiro: "Liste minhas empresas"

Problemas de Autenticação

Verifique novamente se suas credenciais não expiraram
Certifique-se de que não há espaços extras na sua configuração
Tente regenerar suas credenciais OAuth2, se necessário

Ferramentas Disponíveis

Empresas

list_companies - Lista todas as empresas associadas à sua empresa

page: Número da página para paginação (número, opcional, padrão: 1)
per_page: Resultados por página (número, opcional, padrão: 100, máximo: 100)

get_company - Obtém uma empresa específica por ID

company_id: O identificador único da empresa (string, obrigatório)

search_companies - Pesquisa empresas por vários critérios

name_contains: Filtra empresas que contenham este texto no nome (string, opcional)
sector: Filtra empresas por setor (string, opcional)
city: Filtra empresas por cidade (string, opcional)
page: Número da página para paginação (número, opcional, padrão: 1)
per_page: Resultados por página (número, opcional, padrão: 100, máximo: 100)

Métricas Financeiras

get_company_metrics - Obtém métricas para uma empresa específica

company_id: O identificador único da empresa (string, obrigatório)
from_date: Data de início para métricas (formato AAAA-MM-DD) (data, opcional)
to_date: Data de fim para métricas (formato AAAA-MM-DD) (data, opcional)
category: Filtra por categoria de métrica (string, opcional)
cadence: Filtra por cadência de métrica (diária, mensal, etc.) (string, opcional)
include_budgets: Inclui métricas de orçamento nos resultados (booleano, opcional, padrão: false)
page: Número da página para paginação (número, opcional, padrão: 1)
per_page: Resultados por página (número, opcional, padrão: 100, máximo: 100)

get_metrics_options - Obtém categorias e opções de métricas disponíveis

category_name: Filtra por nome de categoria específico (string, opcional)
is_standard: Filtra por métricas padrão vs personalizadas (booleano, opcional)
page: Número da página para paginação (número, opcional, padrão: 1)
per_page: Resultados por página (número, opcional, padrão: 100, máximo: 100)

get_company_recent_metrics - Obtém as métricas mais recentes de uma empresa

company_id: O identificador único da empresa (string, obrigatório)
category: Filtra por categoria de métrica específica (string, opcional)
limit: Número máximo de métricas recentes a retornar (número, opcional, padrão: 10)

Análise de Portfólio

get_portfolio_summary - Obtém um resumo abrangente do portfólio, incluindo empresas, fundos e métricas-chave

company_ids: IDs de empresas específicas a incluir (array de strings, opcional, se None inclui todas as empresas)
max_companies: Número máximo de empresas para incluir métricas (número, opcional, se None inclui todas)
include_metrics: Se deve buscar métricas para cada empresa (booleano, opcional, padrão: true)
metrics_per_company: Número de métricas recentes a buscar por empresa (número, opcional, padrão: 50)

get_company_performance - Obtém dados abrangentes de desempenho para uma empresa específica

company_id: O identificador único da empresa (string, obrigatório)
months: Número de meses de dados históricos a incluir (número, opcional, padrão: 12)

get_company_financial_summary - Obtém um resumo financeiro de uma empresa, incluindo métricas-chave ao longo do tempo

company_id: O identificador único da empresa (string, obrigatório)
months: Número de meses de dados históricos a incluir (número, opcional, padrão: 12)

Orçamentos e Previsões

list_budgets - Lista todos os orçamentos associados à sua empresa

company_slug: Filtra por slug da empresa (string, opcional)
company_id: Filtra por ID da empresa (string, opcional)
page: Número da página para paginação (número, opcional, padrão: 1)
per_page: Resultados por página (número, opcional, padrão: 100, máximo: 100)

Dados Personalizados

get_custom_columns - Obtém dados de colunas personalizadas para empresas

company_slug: Filtra por slug da empresa (string, opcional)
company_id: Filtra por ID da empresa (string, opcional)
page: Número da página para paginação (número, opcional, padrão: 1)
per_page: Resultados por página (número, opcional, padrão: 100, máximo: 100)

get_custom_column_options - Obtém todas as colunas personalizadas e suas opções disponíveis

page: Número da página para paginação (número, opcional, padrão: 1)
per_page: Resultados por página (número, opcional, padrão: 100, máximo: 100)

Documentos

list_documents - Lista todos os documentos associados à sua empresa

company_id: Filtra por ID da empresa (string, opcional)
parse_state: Filtra por estado de análise do documento (string, opcional)
from_date: Filtra documentos a partir desta data (formato AAAA-MM-DD) (data, opcional)
to_date: Filtra documentos até esta data (formato AAAA-MM-DD) (data, opcional)
source: Filtra por fonte do documento (string, opcional)
page: Número da página para paginação (número, opcional, padrão: 1)
per_page: Resultados por página (número, opcional, padrão: 100, máximo: 100)

Fundos

list_funds - Lista todos os fundos associados à empresa

page: Número da página para paginação (número, opcional, padrão: 1)
per_page: Resultados por página (número, opcional, padrão: 100, máximo: 100)

Solicitações e Relatórios de Informações

list_information_requests - Lista todas as solicitações de informações associadas à empresa

name: Filtra por nome da solicitação (string, opcional)
page: Número da página para paginação (número, opcional, padrão: 1)
per_page: Resultados por página (número, opcional, padrão: 100, máximo: 100)

list_information_reports - Lista todos os relatórios de informações associados à empresa

company_id: Filtra por ID da empresa (string, opcional)
information_request_id: Filtra por ID da solicitação de informações (string, opcional)
page: Número da página para paginação (número, opcional, padrão: 1)
per_page: Resultados por página (número, opcional, padrão: 100, máximo: 100)

Notas

list_notes - Lista todas as notas associadas a uma empresa específica

company_slug: Filtra por slug da empresa (string, opcional)
company_id: Filtra por ID da empresa (string, opcional)
sort_by: Ordena notas por campo específico (string, opcional)
page: Número da página para paginação (número, opcional, padrão: 1)
per_page: Resultados por página (número, opcional, padrão: 100, máximo: 100)

get_company_notes_summary - Obtém um resumo das notas de uma empresa

company_id: O identificador único da empresa (string, obrigatório)
recent_notes_limit: O número de notas recentes a retornar (número, opcional, padrão: 5, máximo: 100)

Usuários

list_users - Lista todos os usuários associados à sua empresa

email: Filtra por e-mail do usuário (string, opcional)
page: Número da página para paginação (número, opcional, padrão: 1)
per_page: Resultados por página (número, opcional, padrão: 100, máximo: 100)

Suporte

Problemas com a API Standard Metrics: Entre em contato com o suporte da Standard Metrics
Problemas com o MCP Server: Abra uma issue no GitHub
Problemas com o Claude Desktop: Consulte a documentação do Claude Desktop