Holaspirit Server Mcp

Che cos'è il server Holaspirit MCP?

Il server Holaspirit MCP è uno strumento potente progettato per facilitare l'accesso senza soluzione di continuità alla piattaforma Holaspirit. Funziona come un middleware che collega varie applicazioni e servizi, consentendo agli utenti di interagire con le funzionalità e le caratteristiche di Holaspirit in modo efficiente. Questo server è particolarmente utile per gli sviluppatori che desiderano integrare Holaspirit nei propri sistemi esistenti o creare nuove applicazioni che sfruttano le capacità di Holaspirit.

Caratteristiche del server Holaspirit MCP

• Integrazione semplice: Il server Holaspirit MCP semplifica il processo di connessione alla piattaforma Holaspirit, rendendo più facile per gli sviluppatori integrare le sue funzionalità nelle proprie applicazioni.
• Funzionalità middleware: Funziona come un ponte tra diversi servizi, garantendo una comunicazione e uno scambio di dati fluidi.
• Supporto API robusto: Offre un'API completa che consente agli sviluppatori di accedere a varie funzionalità di Holaspirit, migliorando l'esperienza complessiva dell'utente.
• Open Source: Essendo un repository pubblico, gli sviluppatori possono contribuire al suo sviluppo, personalizzarlo secondo le proprie esigenze e beneficiare del supporto della comunità.
• Documentazione e supporto della comunità: Viene fornito con una documentazione estesa e una comunità attiva, rendendo più facile per gli utenti trovare aiuto e risorse.

Come utilizzare il server Holaspirit MCP

1. Installazione: Inizia installando il server Holaspirit MCP tramite npm. Puoi farlo eseguendo il seguente comando nel tuo terminale:

   npm install holaspirit-mcp-server
   

2. Configurazione: Dopo l'installazione, configura il server impostando le variabili ambientali necessarie e i file di configurazione per connetterti al tuo account Holaspirit.

3. Avvia il server: Avvia il server utilizzando il comando:

   npm start
   

4. Accedi all'API: Una volta che il server è in esecuzione, puoi accedere agli endpoint API per interagire con le funzionalità di Holaspirit. Fai riferimento alla documentazione per informazioni dettagliate sugli endpoint disponibili e sul loro utilizzo.

5. Sviluppa la tua applicazione: Usa l'API per costruire la tua applicazione, integrando le funzionalità di Holaspirit secondo necessità.

Domande frequenti

D1: Qual è lo scopo del server Holaspirit MCP?

R1: Il server Holaspirit MCP è progettato per fornire agli sviluppatori un modo semplice per accedere e integrare le funzionalità di Holaspirit nelle proprie applicazioni.

D2: Il server Holaspirit MCP è gratuito da usare?

R2: Sì, il server Holaspirit MCP è open-source e disponibile gratuitamente su npm.

D3: Dove posso trovare la documentazione per il server Holaspirit MCP?

R3: La documentazione può essere trovata sulla pagina del pacchetto npm e all'interno del repository.

D4: Posso contribuire al server Holaspirit MCP?

R4: Assolutamente! Essendo un progetto open-source, i contributi sono benvenuti. Puoi forkare il repository, apportare modifiche e inviare una pull request.

D5: Quali tecnologie utilizza il server Holaspirit MCP?

R5: Il server è costruito utilizzando Node.js, consentendogli di gestire operazioni asincrone in modo efficiente e fornendo un ambiente robusto per le interazioni API.

holaspirit-mcp-server

A MCP(Model Context Protocol) server that accesses to Holaspirit API.

This server provides MCP-compatible access to Holaspirit's API, allowing AI assistants to interact with your Holaspirit data through a standardized interface.

<a href="https://glama.ai/mcp/servers/7tn35lri9w"><img width="380" height="200" src="https://glama.ai/mcp/servers/7tn35lri9w/badge" alt="Holaspirit Server MCP server" /></a>

Features

Available tools:

• holaspirit_list_tasks - List all tasks in the organization
• holaspirit_list_metrics - List all metrics in the organization
• holaspirit_list_circles - List all circles in the organization
• holaspirit_get_circle - Get details of a specific circle
• holaspirit_list_roles - List all roles in the organization
• holaspirit_get_role - Get details of a specific role
• holaspirit_list_domains - List all domains in the organization
• holaspirit_list_policies - List all policies in the organization
• holaspirit_list_meetings - List all meetings in the organization
• holaspirit_get_meeting - Get details of a specific meeting
• holaspirit_get_member_feed - Get member feed
• holaspirit_get_tensions - Get tensions for a meeting or meetings
• holaspirit_search_member - Search for a member by email

Quick Start

Installation

Installing via Smithery

To install holaspirit-mcp-server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install holaspirit-mcp-server --client claude

Manual Installation

npm install holaspirit-mcp-server

Configuration

You can configure the server using environment variables. Two methods are supported:

Environment Variables

• HOLASPIRIT_API_TOKEN: Your Holaspirit API token
• HOLASPIRIT_ORGANIZATION_ID: Your Holaspirit organization ID

Using .env File

Create a .env file in the project root:

### Copy the example file
cp .env.example .env

Then edit .env with your actual values:

HOLASPIRIT_API_TOKEN=your_api_token_here
HOLASPIRIT_ORGANIZATION_ID=your_organization_id_here

Usage

The server supports two transport modes:

Stdio Transport (Default)

For use with MCP clients that communicate via stdin/stdout:

npx holaspirit-mcp-server

HTTP Transport

For use with web clients or HTTP-based integrations using the latest Streamable HTTP protocol:

npx holaspirit-mcp-server --port 3000

The HTTP server accepts POST requests only on any path (e.g., /, /mcp, /sse) and uses the Streamable HTTP transport protocol.

Edit MCP configuration json for your client:

For stdio transport:

...
    "holaspirit": {
      "command": "npx",
      "args": [
        "-y",
        "holaspirit-mcp-server"
      ],
      "env": {
        "HOLASPIRIT_API_TOKEN": "<your token>",
        "HOLASPIRIT_ORGANIZATION_ID": "<your org id>"
      }
    },
...

For HTTP transport, configure your client to connect to:

• http://localhost:3000/ (or any path)

Development

Available Scripts

• npm run dev - Start the server in development mode with hot reloading
• npm run build - Build the project for production
• npm run start - Start the production server
• npm run lint - Run linting checks (ESLint and Prettier)
• npm run fix - Automatically fix linting issues
• npm run examples - Run the example scripts

Contributing

1. Fork the repository
2. Create your feature branch
3. Run tests and linting: npm run lint
4. Commit your changes
5. Push to the branch
6. Create a Pull Request