MCP Client Setup

⚠️ Prima di iniziare

Ricorda che ti servono le tue credenziali API di Smshosting (se non le hai ancora, controlla la sezione Sviluppatori -> Api Rest, Http, Soap).

Il server MCP di Smshosting è disponibile all'indirizzo https://mcp.smshosting.it/mcp e utilizza il trasporto HTTP Streamable.


Ecco come configurare il nostro server MCP su alcuni agent AI :

Claude Desktop

Puoi aggiungere il server MCP direttamente nel prompt di Claude Desktop in questo modo :

Add an MCP server named "smshosting" to my Claude Desktop config.
Use the mcp-remote bridge with npx.
Server URL: https://mcp.smshosting.it/mcp
Pass these headers via --header args:
  x-smsh-api-key: ${SMSH_KEY}
  x-smsh-api-secret: ${SMSH_SECRET}
Set env vars:
  SMSH_KEY=YOUR_AUTH_KEY
  SMSH_SECRET=YOUR_AUTH_SECRET

Altrimenti puoi modificare il file di configurazione claude_desktop_config.json inserendo il nome del server e le tue credenziali.

{
"mcpServers": {
"smshosting": {
  "command": "npx",
  "args": [
    "-y",
    "mcp-remote",
    "https://mcp.smshosting.it/mcp",
    "--header",
    "x-smsh-api-key: ${SMSH_KEY}",
    "--header",
    "x-smsh-api-secret: ${SMSH_SECRET}"
  ],
  "env": {
    "SMSH_KEY": "YOUR_AUTH_KEY",
    "SMSH_SECRET": "YOUR_SECRET_KEY", 
  }
}
}
}

🔍 Dove trovare il file claude_desktop_config.json?

Se usi Windows : %APPDATA%\Claude\claude_desktop_config.json   

Se usi macOS : ~/Library/Application Support/Claude/claude_desktop_config.json   

Claude Code (CLI)

Puoi aggiungere il server MCP direttamente nel prompt di Claude CLI in questo modo :

Add an MCP server named "smshosting" using HTTP transport.
URL: https://mcp.smshosting.it/mcp
Add these custom headers:
  x-smsh-api-key: YOUR_AUTH_KEY
  x-smsh-api-secret: YOUR_AUTH_SECRET

Cursor

Per aggiungere il server MCP segui questi passi :

Va su Settings -> MCP.

Click Add new global MCP server.

Incolla il JSON di configurazione qui sotto. Cursor rileverà automaticamente gli strumenti disponibili.(indicati da un pallino verde).

{
  "mcpServers": {
    "smshosting": {
      "type": "http",
      "url": "https://mcp.smshosting.it/mcp",
      "headers": {
        "x-smsh-api-key": "YOUR_AUTH_KEY",
        "x-smsh-api-secret": "YOUR_AUTH_SECRET",
      }
    }
  }
}

Codex CLI (OpenAI)

Puoi aggiungere il server MCP direttamente nel prompt di Codex CLI in questo modo :

Add an MCP server named "smshosting" to my Codex config at ~/.codex/config.toml.
Use native Streamable HTTP with URL: https://mcp.smshosting.it/mcp
Set env_http_headers:
  x-smsh-api-key = SMSH_KEY
  x-smsh-api-secret = SMSH_SECRET
Then tell me to export SMSH_KEY and SMSH_SECRET before launching.