Edgee MCP Server

Servidor MCP para a API Edgee, permitindo gerenciamento de organizações, operações de projetos, gerenciamento de componentes e administração de usuários por meio do Model Context Protocol.

Recursos

• Gerenciamento de Organizações: Criar, ler, atualizar e excluir organizações
• Operações de Projetos: Gerenciar projetos, domínios, componentes e estatísticas
• Gerenciamento de Componentes: Trabalhar com componentes, versões e configurações
• Administração de Usuários: Gerenciar usuários, convites e tokens de API
• Tratamento Abrangente de Erros: Mensagens de erro claras para problemas comuns
• API Type-Safe: Construída com TypeScript para verificação robusta de tipos

Ferramentas

Ferramentas de Organização

• edgee-listOrganizations: Listar todas as organizações com filtragem opcional
• edgee-getMyOrganization: Obter sua organização pessoal
• edgee-getOrganization: Obter uma organização por ID
• edgee-createOrganization: Criar uma nova organização
• edgee-updateOrganization: Atualizar uma organização existente
• edgee-deleteOrganization: Excluir uma organização
• edgee-listOrganizationUsers: Listar usuários de uma organização

Ferramentas de Projeto

• edgee-listProjects: Listar todos os projetos com filtragem opcional
• edgee-getProject: Obter um projeto por ID
• edgee-createProject: Criar um novo projeto
• edgee-updateProject: Atualizar um projeto existente
• edgee-deleteProject: Excluir um projeto
• edgee-getProjectCounters: Obter estatísticas de um projeto
• edgee-listProjectDomains: Listar domínios de um projeto
• edgee-createProjectDomain: Criar um novo domínio para um projeto
• edgee-listProjectComponents: Listar componentes de um projeto

Ferramentas de Componente

• edgee-listPublicComponents: Listar todos os componentes públicos
• edgee-listOrganizationComponents: Listar componentes de uma organização
• edgee-getComponentByUuid: Obter um componente por UUID
• edgee-getComponentBySlug: Obter um componente por slug
• edgee-createComponent: Criar um novo componente
• edgee-createComponentVersion: Criar uma nova versão de componente

Ferramentas de Usuário

• edgee-getMe: Obter o usuário atual
• edgee-getUser: Obter um usuário por ID
• edgee-listInvitations: Listar todos os convites
• edgee-createInvitation: Criar um novo convite
• edgee-deleteInvitation: Excluir um convite
• edgee-listApiTokens: Listar todos os tokens de API
• edgee-createApiToken: Criar um novo token de API
• edgee-deleteApiToken: Excluir um token de API
• edgee-getUploadPresignedUrl: Obter uma URL pré-assinada para upload de arquivos

Configuração

Token de Acesso Pessoal

Crie um Token de Acesso Pessoal Edgee:

• Vá para Tokens de API (em Configurações da Conta > Tokens de API)
• Crie um token
  • Dê um nome a este token
  • Selecione um período de validade para o token que você está prestes a criar. Se nenhuma duração for selecionada, o token nunca expirará.
• Copie o token gerado

Instalação

Você pode usar este servidor MCP de várias maneiras:

NPX (Recomendado)

npx @edgee/mcp-server-edgee

Instalação Global

npm install -g @edgee/mcp-server-edgee

Instalação Local

npm install @edgee/mcp-server-edgee

Uso com Claude Desktop

Para usar com o Claude Desktop, adicione o seguinte ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "edgee": {
      "command": "npx",
      "args": [
        "-y",
        "@edgee/mcp-server-edgee"
      ],
      "env": {
        "EDGEE_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

Exemplos

Listar Organizações

Use the edgee-listOrganizations tool to list all your organizations.

Criar um Projeto

Use the edgee-createProject tool to create a new project with the following parameters:
- organization_id: "org_123456"
- slug: "my-new-project"
- description: "This is my new project"

Obter Componentes do Projeto

Use the edgee-listProjectComponents tool to list all components for project "proj_123456".

Criar um Convite

Use the edgee-createInvitation tool to invite a user to your organization:
- organization_id: "org_123456"
- email: "user@example.com"
- role: "member"

Desenvolvimento

Compilando a partir do Código-Fonte

git clone https://github.com/edgee-cloud/mcp-server-edgee.git
cd mcp-server-edgee
npm install
npm run build

Licença

Apache-2.0