SheetsData
Acesso instantâneo a datasheets de componentes eletrônicos para agentes de IA — especificações, pinagens, informações de encapsulamento e classificações máximas absolutas extraídas de PDFs de fabricantes sob demanda.
Documentação
SheetsData MCP
Datasheets de componentes eletrônicos para agentes de IA — especificações, pinagens e dados de encapsulamento sob demanda. Sem necessidade de PDFs.
SheetsData é um servidor MCP que dá aos agentes de IA acesso instantâneo e estruturado a dados de componentes eletrônicos. Uma chamada de ferramenta retorna a pinagem. Outra retorna as especificações elétricas. Sem PDFs. Sem uploads. Sem sobrecarregar a janela de contexto.
Beta — O SheetsData está atualmente em beta público. APIs, preços e recursos podem mudar. Consulte o Aviso legal abaixo.
Cadastre-se e conecte via OAuth · Chave de API (alternativa) · Site
Demonstração
Agent: read_datasheet("TPS54302", section="pinout")
→ Pin table: BOOT(6), EN(5), FB(4), GND(1), SW(2), VIN(3)
Agent: check_design_fit("TPS54302", input_voltage=12, output_current=2)
→ PASS — all parameters within datasheet limits
Agent: "What's the maximum SPI clock frequency for the STM32G030?"
→ Uses read_datasheet to find electrical specs — returns 32 MHz
Agent: find_alternative("TPS54302", constraints="in_stock")
→ MP2315, TPS54331 ranked by package/spec match
O agente nunca vê um PDF. O engenheiro nunca envia um.
Ferramentas
| Ferramenta | Descrição |
|---|---|
search_parts | Busca componentes por número de peça ou palavra-chave. Resultados consolidados por MPN com preço e estoque. |
search_datasheets | Busca semântica em todos os datasheets extraídos. Consultas em linguagem natural como "LDO de baixo ruído com PSRR acima de 70dB". |
prefetch_datasheets | Extração em lote para até 20 peças. Dispare e esqueça — reduz tempos de espera. |
check_extraction_status | Consulta o progresso da extração após prefetch ou read_datasheet. |
get_part_details | Detalhes completos do componente — especificações, parâmetros, preço e estoque. |
read_datasheet | Seções estruturadas do datasheet (resumo, pinagem, elétrico, abs_max, encapsulamento) ou busca semântica dentro de um datasheet. |
compare_parts | Compara 2–5 peças lado a lado com base nas especificações reais do datasheet. |
check_design_fit | Valida condições de operação contra os limites do datasheet. PASS/FAIL/WARNING por parâmetro. |
find_alternative | Encontra componentes alternativos/substitutos por especificações, encapsulamento ou disponibilidade. |
analyze_image | Análise por IA de visão de imagens de datasheets — gráficos, desenhos de encapsulamento, diagramas de pinos. |
request_datasheet_upload | Solicita uma URL assinada para enviar um PDF de datasheet quando não temos um (datasheet_status = no_source ou unsupported). Gratuito — a taxa é cobrada apenas na confirmação. |
confirm_datasheet_upload | Confirma um upload: verifica SHA-256, valida o PDF, confere o MPN na primeira página, cobra a taxa de upload e enfileira a extração. Datasheets são privados da sua organização. |
Prompts
Modelos de prompt integrados que guiam o agente em tarefas comuns de engenharia de hardware:
| Prompt | Descrição |
|---|---|
component-selection | Guia a seleção de um componente: definir requisitos, buscar candidatos, comparar especificações, validar adequação ao projeto. |
bom-review | Revisa uma lista de materiais: consulta cada peça, verifica estoque e ciclo de vida, sinaliza riscos, sugere alternativas. |
datasheet-deep-dive | Análise aprofundada de uma peça específica: resumir, extrair pinagem, especificações elétricas, classificações máximas absolutas e circuito de aplicação. |
design-validation | Valida um projeto: verifica cada componente contra as condições de operação, sinaliza parâmetros fora da especificação. |
second-source | Encontra alternativas de segunda fonte para uma peça: compara encapsulamento, especificações e disponibilidade entre fornecedores. |
interface-check | Verifica compatibilidade elétrica e de protocolo entre dois CIs em um barramento compartilhado (SPI, I2C, UART). Verifica VOH/VOL vs VIH/VIL, sinaliza necessidade de level shifter, extrai configuração de protocolo (modo SPI, endereço I2C, valores de pull-up). |
firmware-kickstart | Extrai mapa de registradores, sequência de inicialização e detalhes de protocolo de um datasheet de CI periférico. Gera um guia de integração de firmware com escritas de registradores, exemplos de transações e armadilhas comuns. |
thermal-review | Análise térmica e de derating: compara condições de operação contra limites de abs max E recomendados, estima temperatura de junção, verifica curvas de derating de SOA, sinaliza requisitos de exposed pad. |
Recursos
Dados que o servidor expõe para contexto do agente:
| Recurso | Descrição |
|---|---|
sheetsdata://workflow | Fluxo de trabalho recomendado de ferramentas para seleção de componentes — buscar, avaliar, ler datasheet, validar, comparar. |
sheetsdata://tips/datasheet-pitfalls | Os 8 erros mais comuns de interpretação de datasheets — confusão com abs max, típico vs pior caso, derating térmico, níveis de tensão, pegadinhas de I2C/SPI, desacoplamento, exposed pads, riscos de ciclo de vida. |
sheetsdata://tips/design-review-checklist | Checklist de revisão de design de hardware cobrindo fonte de alimentação, interfaces de sinal, seleção de componentes e integração de firmware. |
Autenticação — escolha OAuth, use chave de API como alternativa
O SheetsData suporta dois caminhos de autenticação. Use o que funcionar melhor para o seu cliente; ambos cobram na mesma organização.
| OAuth 2.0 | Chave de API | |
|---|---|---|
| Melhor para | Clientes MCP interativos (Claude Desktop, Cursor, etc.) | CI, scripts, agentes headless ou clientes que não suportam OAuth do MCP |
| O que você faz | Clique em Conectar no seu cliente → faça login aqui → pronto | Gere uma chave no painel, cole como cabeçalho Bearer |
| Configuração | Basta colar uma URL | Cole uma URL + um cabeçalho |
| Descoberta | Automática via RFC 8414 / RFC 9728 | n/a |
| Conformidade com especificação | PKCE obrigatório, registro dinâmico de cliente (RFC 7591), rotação de refresh token | RFC 6750 Bearer |
| Revogação | Por cliente, em /dashboard/keys | Exclua a chave |
Recomendado: OAuth. É uma única colagem de URL, sem copiar e colar segredos, e você pode remover um aplicativo conectado do painel a qualquer momento.
Caminhos mais rápidos (instalação em um clique)
Claude Desktop — baixe o pacote .mcpb da última versão no GitHub e arraste e solte na janela do Claude Desktop. O diálogo de instalação mostrará todas as ferramentas que o pacote fornece antes de confirmar. Deixe o campo de chave de API em branco para usar OAuth (recomendado) — o Claude Desktop abrirá uma aba do navegador no primeiro uso para autorizar. Sem edição de JSON.
Cursor ou VS Code — instalação em um clique pré-preenche a configuração e solicita autorização no primeiro uso.
Para qualquer outro caso, copie o trecho da seção à direita abaixo.
Instalação
Claude Desktop
Mais fácil — arraste e solte a extensão empacotada. Baixe o sheetsdata-x.y.z.mcpb mais recente da página de Releases e solte o arquivo na janela do Claude Desktop. O Claude mostra a lista de ferramentas que o pacote fornece e instala. Deixe o campo de chave de API em branco para usar OAuth (recomendado) — uma aba do navegador abre no primeiro uso para autorizar. Sem edição de JSON, sem npm install.
Ou — adicione um conector remoto pela interface. Abra o Claude Desktop → Configurações → Conectores → Adicionar conector personalizado no final da lista.
| Campo | Valor |
|---|---|
| Nome | SheetsData |
| URL | https://mcp.sheetsdata.com/mcp |
Clique em Adicionar. O Claude Desktop abrirá uma aba do navegador para a tela de consentimento do SheetsData — escolha a organização para autorizar e pronto. As ferramentas aparecem no Claude imediatamente.
Nota: O arquivo
claude_desktop_config.jsonnão suporta o fluxo OAuth no Claude Desktop. A interface de Conectores é o caminho certo para OAuth — use a configuração JSON apenas se quiser usar uma chave de API.
Use uma chave de API (via configuração JSON)
Abra o Claude Desktop → Configurações → Desenvolvedor → Editar Config, e adicione em ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"sheetsdata": {
"url": "https://mcp.sheetsdata.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Reinicie o Claude Desktop. Obtenha uma chave em sheetsdata.com/dashboard/keys.
Claude Code
claude mcp add sheetsdata --transport http "https://mcp.sheetsdata.com/mcp"
O Claude Code exibirá uma URL OAuth de uso único — abra-a, autorize, pronto.
Use uma chave de API
claude mcp add sheetsdata \
--transport http \
"https://mcp.sheetsdata.com/mcp" \
--header "Authorization: Bearer YOUR_API_KEY"
Cursor
Clique no selo Instalar no Cursor acima, ou adicione em .cursor/mcp.json:
{
"mcpServers": {
"sheetsdata": {
"url": "https://mcp.sheetsdata.com/mcp"
}
}
}
Reinicie o Cursor → painel MCP → SheetsData → Conectar.
Use uma chave de API
{
"mcpServers": {
"sheetsdata": {
"url": "https://mcp.sheetsdata.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
VS Code (GitHub Copilot)
Clique no selo Instalar no VS Code acima, ou adicione em .vscode/mcp.json:
{
"servers": {
"sheetsdata": {
"type": "http",
"url": "https://mcp.sheetsdata.com/mcp"
}
}
}
O VS Code solicitará autorização no primeiro uso.
Use uma chave de API
{
"servers": {
"sheetsdata": {
"type": "http",
"url": "https://mcp.sheetsdata.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Windsurf
Adicione em ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"sheetsdata": {
"url": "https://mcp.sheetsdata.com/mcp"
}
}
}
Reinicie o Windsurf e clique em Conectar na entrada do SheetsData.
Use uma chave de API
{
"mcpServers": {
"sheetsdata": {
"url": "https://mcp.sheetsdata.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Amp (Sourcegraph)
Adicione nas configurações do Amp:
{
"amp.mcpServers": {
"sheetsdata": {
"url": "https://mcp.sheetsdata.com/mcp"
}
}
}
O Amp executará o fluxo OAuth no primeiro uso.
Use uma chave de API
{
"amp.mcpServers": {
"sheetsdata": {
"url": "https://mcp.sheetsdata.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Cline
O Cline ainda não suporta o fluxo OAuth do MCP — use uma chave de API.
No VS Code, abra o Cline → ícone de engrenagem → MCP Servers:
{
"mcpServers": {
"sheetsdata": {
"url": "https://mcp.sheetsdata.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
},
"disabled": false
}
}
}
Zed
O Zed ainda não suporta o fluxo OAuth do MCP — use uma chave de API.
Adicione em Zed settings.json:
{
"context_servers": {
"sheetsdata": {
"settings": {
"url": "https://mcp.sheetsdata.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
}
Continue.dev
O Continue ainda não suporta o fluxo OAuth do MCP — use uma chave de API.
Adicione em ~/.continue/config.yaml:
mcpServers:
- name: sheetsdata
url: https://mcp.sheetsdata.com/mcp
headers:
Authorization: "Bearer YOUR_API_KEY"
npx (proxy stdio para qualquer cliente)
Para clientes que suportam apenas transporte stdio:
SHEETSDATA_API_KEY=your_key npx @sheetsdata/mcp
Precisa de uma chave de API?
- Cadastre-se em sheetsdata.com/signup (30 segundos, créditos gratuitos)
- Vá para Dashboard → API Keys
- Clique em Criar chave, copie o token e cole na sua configuração
Você também pode gerenciar aplicativos autorizados via OAuth na mesma página — veja quem conectou, quando, e revogue qualquer um com um clique.
Fluxo de Trabalho Recomendado
1. search_parts → Find candidates by keyword or part number
2. get_part_details → Evaluate pricing, stock, parameters
3. read_datasheet → Get detailed specs (pinout, electrical, package)
4. check_design_fit → Validate against your operating conditions
5. find_alternative → Find substitutes if needed
6. compare_parts → Side-by-side comparison of finalists
Suporte
- E-mail: support@octoco.ltd
- Issues: github.com/octoco-ltd/sheetsdata-mcp/issues
- Site: sheetsdata.com
Aviso Legal
O SheetsData está atualmente em beta público. Os dados são extraídos de datasheets de fabricantes publicamente disponíveis usando ferramentas automatizadas, incluindo IA. Podem conter erros, omissões ou imprecisões.
O SheetsData e a Octoco Ltd fornecem estes dados "como estão" e não oferecem garantias, expressas ou implícitas, quanto à precisão, integridade ou adequação a qualquer finalidade específica. Sempre verifique especificações críticas no datasheet oficial do fabricante antes de tomar decisões de design, compra ou fabricação.
Ao usar este serviço, você reconhece que:
- Os dados extraídos podem diferir do datasheet original do fabricante
- O SheetsData não substitui a revisão da documentação oficial
- A Octoco Ltd não é responsável por quaisquer danos, perdas ou falhas de design decorrentes do uso destes dados
- Recursos, APIs e preços estão sujeitos a alterações durante o período beta
Para termos de uso, consulte sheetsdata.com/terms.
Licença
MIT