6 minutos de leitura

Visão geral

Reading onchain data and managing blockchain infrastructure often involves provisioning endpoints, scripting API calls, and navigating dashboards. The Quicknode MCP server replaces that with natural language. You can query live blockchain data across every supported network, manage endpoints, monitor usage, configure security settings, analyze billing data, and more.

Este guia explica como integrar o MCP com assistentes de IA como Claude e o Cursor, permitindo-lhe aumentar a sua produtividade e otimizar o seu fluxo de trabalho de desenvolvimento Web3.

Building with AI Agents?

Quicknode is built for the agentic era. Explore our full suite of AI-ready tools, including LLM-optimized docs, blockchain skills, and agentic payments at Build with AI or visit quicknode.com/agents to learn more.

O que irá fazer

• Descubra o servidorQuicknode e como funciona
• Ligar o Quicknode ao Claude
• Autentique-se com Quicknode sua Quicknode através do OAuth e selecione uma função de acesso
• Read live blockchain data with read-only JSON-RPC calls, with no endpoint to provision
• Casos práticos de utilização para a gestão de terminais, monitorização da utilização e reforço da segurança através de comandos simples

O que vai precisar

• Uma Quicknode
• Um assistente de IA compatível com MCP (por exemplo, Claude , Claude , Cursor, VS Code, Windsurf, Zed)
• Conhecimentos básicos sobre a utilização da IA

O que é o Quicknode ?

The Quicknode MCP is a remote server that acts as a bridge between AI assistants and Quicknode. It enables you to read live blockchain data and interact with your Quicknode endpoints, billing data, usage analytics, and security settings through natural language commands. Instead of writing custom scripts or manually navigating the Quicknode dashboard, you can now query chains and manage your infrastructure conversationally.

informações

O Quicknode é uma ferramenta fundamental que irá evoluir. Estamos empenhados em expandir as suas capacidades ao longo do tempo, para melhorar ainda mais o seu fluxo de trabalho. Se tiver algum comentário ou sugestão, por favor, informe-nos através do formulário na parte inferior desta página.

O MCP permite-lhe realizar as seguintes ações, entre outras, através de comandos em linguagem natural:

• Read live blockchain data: Make read-only JSON-RPC calls on any supported network
• Gerir pontos finais: Crie, atualize e elimine pontos finais com facilidade
• Monitorização da utilização: Acompanhe endpoint e os dados de faturação em tempo real
• Configurar as definições de segurança: definir a limitação de taxa, a lista de IPs autorizados e muito mais
• Analisar dados de faturação: obtenha informações sobre a sua utilização e custos com a IA

Configuração do Quicknode

O servidor Quicknode está alojado remotamente, pelo que não é necessário instalar nada localmente. A ligação é feita adicionando o URL do servidor ao seu assistente de IA. Neste guia, iremos utilizar Claude , mas a configuração é semelhante para outros clientes.

Para obter instruções de configuração para todos os clientes suportados (Claude , Claude , Cursor, VS Code, Windsurf, Zed e outros), consulte a documentaçãoQuicknode .

1. Execute o seguinte comando no seu terminal para adicionar o servidor Quicknode :

claude adicionar quicknode --transport httpquicknode

2. Inicie Claude e escreva /mcp para autorizar o servidor. Será aberta uma janela do navegador onde deverá iniciar sessão com Quicknode sua Quicknode .
3. Se tiver várias Quicknode , selecione aquela à qual pretende ligar-se.
4. Escolha o seu Função da chave API:
   • Viewer — Read-only access. Allows reading live blockchain data, and viewing endpoints, metrics, logs, usage, and billing, but cannot make changes.
   • Admin — Everything Viewer can do, plus write access: creating/deleting endpoints, modifying security rules, and updating rate limits.
5. Clique em «Concordo e autorizo o acesso». O servidor MCP está agora ligado.

informações

flow de autorização flow , em segundo plano, uma chave API com o âmbito da função que selecionou. Não precisa de criar nem gerir a chave por conta própria. Se precisar de mudar de função mais tarde, remova o servidor e volte a adicioná-lo para flow o flow .

Utilizar uma chave API em vez do OAuth

If you're running in a headless environment where a browser login isn't possible (e.g., CI/CD pipelines, remote VMs, or automation agents), you can skip the OAuth flow by passing your API key directly:

claude adicionar quicknode --transport httpquicknode--header "Authorization: Bearer A SUA_CHAVE_API"

Gere uma chave API a partir do Quicknode , em Conta (ícone do avatar) > Chaves API. A função que atribuir à chave (Administrador ou Visualizador) determina as permissões do servidor MCP. Para obter instruções de configuração com outros clientes, consulte a documentaçãoQuicknode .

Utilização do Quicknode

Não precisa de se lembrar de nomes específicos de ferramentas ou chamadas de API; basta descrever o que pretende em linguagem natural. O MCP interpreta a sua intenção, seleciona a ferramenta adequada e executa-a. No caso de operações de gravação (criação de pontos de extremidade, alteração da segurança, etc.), o assistente solicitará a sua confirmação antes de prosseguir.

Por exemplo, ao solicitar «Criar um novoendpoint mainnet Bitcoin endpoint aplicar algumas definições de segurança», as ferramentas adequadas serão acionadas automaticamente:

informações

Para consultar a lista completa das ferramentas disponíveis e os respetivos níveis de acesso, consulte a documentaçãoQuicknode .

A seguir, apresentamos alguns exemplos de instruções organizados por caso de utilização para o ajudar a dar os primeiros passos.

Reading Live Blockchain Data

O call-rpc tool reads onchain data. It sends a read-only JSON-RPC request through your account's Tooling Access setting, which covers every network Quicknode supports. You never create an endpoint, copy a URL, or handle a credential. The server mints and refreshes a short-lived credential for each call.

Tooling Access is an account-level setting. Ask the assistant to enable it, and it runs the enable-tooling-access tool. That tool needs the Admin role, so if you connected as a Viewer, enable Tooling Access from an Admin connection first. You only do this once: the same setting powers qn rpc call in the Quicknode CLI and the rpc client in the QuickNode SDK.

Querying State:

• "What is the current block number on Base?"
• "Get the balance of 5s3vajJvaAbabQvxFdiMfg14y23b2jvK6K2Mw4PYcYK on Solana mainnet"
• "Check whether this contract is deployed on Polygon"

Comparing Across Chains:

• "Read the latest block on Ethereum and on Arbitrum, then compare the timestamps"
• "Get the current gas price on Base, Optimism, and Arbitrum"

informações

Calls are read-only. Write methods such as eth_sendRawTransaction are rejected. To send transactions, create a dedicated endpoint and call it from your own code.

Gestão Endpoint

Criação e configuração de novos pontos finais:

• "Create a new Base mainnet endpoint with high rate limits for our production trading bot"
• «Configure restrições de segurança no novo endpoint permitir apenas pedidos provenientes do IP do nosso servidor»

Monitorização e manutenção:

• «Mostra-me quais são os pontos finais que não foram utilizados nos últimos 30 dias»
• «Quais são os 5 métodos RPC mais chamados em todos os meus pontos finais?»
• «Verifique se houve algum pedido que tenha falhado na última hora no nossoendpointmainnet Ethereum »

Segurança e Controlo de Acesso

Implementação de políticas de segurança:

• "Adicionar autenticação JWT a todos Solana "
• «Criar restrições de lista branca de IP para os nossos pontos de acesso de desenvolvimento interno»
• «Definir restrições de origem para os nossos pontos de extremidade voltados para o front-end»

Auditoria de segurança:

• «Analise as definições de segurança em todos os terminais e identifique aqueles que não dispõem de autenticação adequada»
• «Gerar um relatório de conformidade de segurança para a nossa infraestrutura»

Otimização de custos e faturação

Análise de utilização:

• «Qual é endpoint a receber mais pedidos este mês e o que está a motivar essa utilização?»
• «Comparar os nossos padrões de utilização do RPC entre este mês e o mês passado»
• «Identificar oportunidades para reduzir custos através da consolidação de terminais subutilizados»

Gestão de faturação:

• «Mostra-me a evolução da nossa faturação nos últimos 6 meses»
• «Qual é a nossa previsão de despesas para este mês, com base no consumo atual?»
• "Break down our costs by blockchain network and identify the highest contributors"

Depuração e resolução de problemas

Análise de desempenho:

• «Mostra-me os tempos de resposta e as taxas de erro de todos os pontos finais nas últimas 24 horas»
• «Identificar quaisquer terminais que apresentem latência elevada ou taxas de erro elevadas»
• «Identificar padrões nas solicitações falhadas que possam indicar problemas de configuração»

Análise do registo:

• «Pesquisar nos registos quaisquer pedidos que tenham devolvido erros 500 no nossoendpointmainnet Base »
• «Mostra-me os padrões de pedidos que conduziram às violações do limite de taxa de ontem»
• «Encontrar todos os pedidos provenientes de um endereço IP específico em todos os pontos finais»

Conclusão

You’ve successfully configured the Quicknode MCP, a new and efficient way to read live blockchain data and manage your infrastructure with the help of AI. By using natural language commands, you can now handle complex tasks in seconds, allowing you to dedicate more time to building and scaling your Web3 applications with Quicknode.

Whether you're a solo developer prototyping your first dApp or an enterprise team managing complex multi-chain infrastructure, Quicknode MCP adapts to your workflow and scales with your needs. Tools like Quicknode MCP will become essential for teams that want to stay competitive and deliver high-quality applications at scale.

Subscribe to our newsletter for more articles and guides on Web3 and blockchain. If you have any questions or need further assistance, feel free to join our Discord server or share feedback in the feedback section at the end of this page. Stay informed and connected by following us on X (@Quicknode) and our Telegram announcement channel.