Servidor MCP

Utilitza IPFS Ninja directament des d'assistents de programació amb IA com Claude Code, Cursor i Windsurf. Puja fitxers, fixa CID, gestiona carpetes i consulta l'ús — tot des de la teva conversa amb IA.

Què és MCP?

Model Context Protocol (MCP) és un estàndard obert per connectar assistents d'IA amb eines i fonts de dades externes. El servidor MCP d'IPFS Ninja exposa 11 eines que els models d'IA poden cridar durant les converses per interactuar amb el teu compte d'IPFS Ninja.

Instal·lació

Paquet npm

@ipfs-ninja/mcp-server

Disponible a npm. No cal instal·lació global — s'executa via npx.

Requisits previs

• Node.js 18+ instal·lat
• Una clau API d'IPFS Ninja (aconsegueix-ne una a Dashboard > API Keys)

Configuració per a Claude Code

Pas 1: Aconsegueix la teva clau API

1. Registra't a ipfs.ninja (gratuït)
2. Ves a Dashboard > API Keys
3. Fes clic a Create API key i copia la clau completa (només es mostra un cop)

Pas 2: Afegeix el servidor MCP

Executa aquesta comanda al terminal:

claude mcp add ipfs-ninja \
  --transport stdio \
  -e IPFS_NINJA_API_KEY=bws_your_full_api_key_here \
  -- npx -y @ipfs-ninja/mcp-server

O afegeix manualment al teu .claude/settings.json:

{
  "mcpServers": {
    "ipfs-ninja": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@ipfs-ninja/mcp-server"],
      "env": {
        "IPFS_NINJA_API_KEY": "bws_your_full_api_key_here"
      }
    }
  }
}

Pas 3: Reinicia Claude Code

Surt i torna a obrir Claude Code. Escriu /mcp per verificar que el servidor d'IPFS Ninja està connectat.

Pas 4: Comença a utilitzar-lo

Simplement parla amb Claude de manera natural:

You: Upload my README.md to IPFS
You: List my recent files
You: How much storage am I using?
You: Pin bafyabc123... from the IPFS network
You: Create a folder called "project-assets"

Configuració per a Cursor / Windsurf

Afegeix a la configuració de MCP (Settings > MCP Servers):

Configuració	Valor
Name	ipfs-ninja
Transport	stdio
Command	npx
Args	-y @ipfs-ninja/mcp-server
Environment	IPFS_NINJA_API_KEY=bws_...

Eines disponibles

Operacions amb fitxers

Eina	Descripció	Exemple de prompt
ipfs_upload	Puja contingut d'un fitxer (base64 o text)	"Upload this HTML file to IPFS"
ipfs_upload_json	Puja un objecte JSON	"Store this config as a permanent JSON on IPFS"
ipfs_list	Llista els teus fitxers pujats	"Show my recent uploads"
ipfs_get	Obté metadades d'un fitxer per CID	"What type of file is QmXyz...?"
ipfs_delete	Desfixa i elimina un fitxer	"Delete QmXyz... from my account"

Fixació (Pinning)

Eina	Descripció	Exemple de prompt
ipfs_pin	Fixa un CID existent de la xarxa	"Pin bafyabc... to my account"
ipfs_pin_status	Comprova el progrés de la fixació	"Is bafyabc... done pinning?"

Organització

Eina	Descripció	Exemple de prompt
ipfs_folders_list	Llista les teves carpetes	"Show my folders"
ipfs_folders_create	Crea una carpeta nova	"Create a folder called nft-metadata"

Compte

Eina	Descripció	Exemple de prompt
ipfs_profile	Informació del pla, emmagatzematge i ample de banda	"How much storage am I using?"
ipfs_analytics	Estadístiques diàries d'ample de banda i fitxers	"Show my bandwidth usage this week"

Fluxos de treball d'exemple

Publicar un lloc estàtic

You: Upload the contents of my dist/ folder to IPFS
Claude: [uploads each file, returns CIDs]

You: What's the CID for index.html?
Claude: [calls ipfs_get]
     → QmXyz... — https://ipfs.ninja/ipfs/QmXyz...

Metadades NFT

You: Create a folder called "my-collection" and upload this metadata JSON
Claude: [calls ipfs_folders_create, then ipfs_upload_json]
     → Folder: my-collection
     → CID: QmAbc... — permanent metadata URL ready for your smart contract

Monitorització de l'ús

You: Am I close to my storage limit?
Claude: [calls ipfs_profile]
     → Plan: Bodhi, Storage: 45.2 MB / 100 GB (0.04%)
     → You have plenty of room.

You: Show my bandwidth this week
Claude: [calls ipfs_analytics with days=7]
     → 2.3 MB bandwidth, 45 requests across 3 days

Fixar contingut de la xarxa

You: Pin the IPFS readme at QmYwAPJzv5CZsnA625s3Xf2nemtYgPpHdWEz79ojWnPbdG
Claude: [calls ipfs_pin]
     → Pin initiated! Status: pinning

You: Is it done?
Claude: [calls ipfs_pin_status]
     → Status: pinned, Size: 0.008 MB

Resolució de problemes

"IPFS_NINJA_API_KEY environment variable is required"

La clau API no està configurada. Assegura't que la secció env de la configuració MCP conté la clau correcta.

"API error 402: not enough storage"

Has arribat al límit d'emmagatzematge del teu pla. Millora a ipfs.ninja/pricing o elimina fitxers no utilitzats.

"API error 403: Forbidden"

La teva clau API pot ser invàlida o haver caducat. Crea'n una de nova a Dashboard > API Keys.

El servidor no apareix a /mcp

Assegura't d'haver reiniciat Claude Code després d'afegir el servidor MCP. Comprova que Node.js 18+ està instal·lat (node --version).