Holaspirit Servidor Mcp

O que é o Servidor MCP do Holaspirit?

O Servidor MCP do Holaspirit é uma ferramenta poderosa projetada para facilitar o acesso contínuo à plataforma Holaspirit. Ele atua como um middleware que conecta várias aplicações e serviços, permitindo que os usuários interajam com os recursos e funcionalidades do Holaspirit de forma eficiente. Este servidor é particularmente útil para desenvolvedores que desejam integrar o Holaspirit em seus sistemas existentes ou criar novas aplicações que aproveitem as capacidades do Holaspirit.

Recursos do Servidor MCP do Holaspirit

• Integração Fácil: O Servidor MCP do Holaspirit simplifica o processo de conexão à plataforma Holaspirit, tornando mais fácil para os desenvolvedores integrarem seus recursos em suas aplicações.
• Funcionalidade de Middleware: Atua como uma ponte entre diferentes serviços, garantindo comunicação e troca de dados suaves.
• Suporte Robusto a API: Oferece uma API abrangente que permite aos desenvolvedores acessar várias funcionalidades do Holaspirit, melhorando a experiência geral do usuário.
• Código Aberto: Sendo um repositório público, os desenvolvedores podem contribuir para seu desenvolvimento, personalizá-lo de acordo com suas necessidades e se beneficiar do suporte da comunidade.
• Documentação e Suporte da Comunidade: Vem com documentação extensa e uma comunidade ativa, facilitando para os usuários encontrarem ajuda e recursos.

Como Usar o Servidor MCP do Holaspirit

1. Instalação: Comece instalando o Servidor MCP do Holaspirit via npm. Você pode fazer isso executando o seguinte comando no seu terminal:

   npm install holaspirit-mcp-server
   

2. Configuração: Após a instalação, configure o servidor configurando as variáveis de ambiente necessárias e os arquivos de configuração para conectar à sua conta do Holaspirit.

3. Iniciar o Servidor: Inicie o servidor usando o comando:

   npm start
   

4. Acessar a API: Uma vez que o servidor esteja em execução, você pode acessar os endpoints da API para interagir com os recursos do Holaspirit. Consulte a documentação para obter informações detalhadas sobre os endpoints disponíveis e seu uso.

5. Desenvolver Sua Aplicação: Use a API para construir sua aplicação, integrando as funcionalidades do Holaspirit conforme necessário.

Perguntas Frequentes

Q1: Qual é o propósito do Servidor MCP do Holaspirit?

A1: O Servidor MCP do Holaspirit foi projetado para fornecer aos desenvolvedores uma maneira fácil de acessar e integrar os recursos do Holaspirit em suas aplicações.

Q2: O Servidor MCP do Holaspirit é gratuito para usar?

A2: Sim, o Servidor MCP do Holaspirit é de código aberto e está disponível gratuitamente no npm.

Q3: Onde posso encontrar a documentação para o Servidor MCP do Holaspirit?

A3: A documentação pode ser encontrada na página do pacote npm e dentro do repositório.

Q4: Posso contribuir para o Servidor MCP do Holaspirit?

A4: Absolutamente! Como um projeto de código aberto, contribuições são bem-vindas. Você pode fazer um fork do repositório, fazer alterações e enviar um pull request.

Q5: Quais tecnologias o Servidor MCP do Holaspirit utiliza?

A5: O servidor é construído usando Node.js, permitindo que ele lide com operações assíncronas de forma eficiente e fornecendo um ambiente robusto para interações com a 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