freispace MCP Server

freispace MCP Server

Um servidor Model Context Protocol (MCP) que fornece análises e insights para o software de agendamento freispace. Este servidor permite que assistentes de IA (ex.: Copilot, Gemini) consultem dados dentro do freispace, como estatísticas de projetos e informações relacionadas ao planejamento.

Visão Geral

O freispace MCP Server conecta qualquer LLM com capacidades de ferramentas ao freispace para consultar dados analíticos.

Equipes de mídia que utilizam o freispace podem aproveitar o servidor MCP para disponibilizar dados de planejamento para toda a empresa usando a IA corporativa (ex.: Copilot), sem que os usuários precisem estar no freispace ou sequer conhecê-lo, além de ajudar equipes de pós-produção a tomar decisões baseadas em dados durante o agendamento e planejamento.

Nosso MCP Server sempre respeita as permissões do usuário, garantindo que o LLM só possa acessar dados em nível individual, assegurando a segurança dos dados.

Exemplos de consultas podem ser "Quem trabalhou com a Pessoa X no passado" ou "Quantos dias de férias ainda tenho?"

Pré-requisitos

1. Conta no freispace Flagship
2. Chave de API MCP válida para o freispace
   • Durante beta, entre em contato com sua equipe de suporte do freispace para obter uma chave de API MCP

Ferramentas Disponíveis

Todas as buscas são baseadas em nome. Nomes parciais são correspondidos; a primeira correspondência é usada.

get_current_user

Quem é o usuário autenticado: nome, e-mail e registro de equipe vinculado. Sem argumentos. Use para resolver "eu"/"me"/"meu" para um nome de equipe.

"Como quem estou logado?"

get_staffs

Lista membros da equipe com nome, cargo e número de matrícula.

• status (opcional): active (padrão), inactive, all

"Listar todos os membros da equipe" · "Quem são os desenvolvedores na empresa?"

find_resources

Busca salas/estúdios (suítes), equipamentos/licenças (recursos) e equipe por nome em uma única chamada, agrupados por tipo.

• search (opcional): nome ou parte do nome; omita para listar tudo
• staff (opcional): internal ou external
• site (opcional): apenas suítes em locais correspondentes
• status (opcional): active (padrão), inactive, all

"Encontrar Sammy" · "Listar freelancers externos"

get_availability

Verifica quando equipe, suítes ou recursos estão livres em uma janela de datas (padrão 14 dias, máx. 92), considerando reservas, feriados e ausências/horários de trabalho da equipe.

• type (obrigatório): staff, resource, suite ou site
• search, staff, site, status (opcional): seleção de entidade como em find_resources
• from, to, days, weeks (opcional): a janela de datas
• duration + duration_unit (opcional): duração livre necessária (minutes, hours ou days)

"Um estúdio está livre na próxima terça por 3 horas?" · "Quem tem 2 dias completamente livres nas próximas duas semanas?"

get_my_schedule

As próprias reservas do usuário autenticado em uma janela de datas (padrão: próximos 7 dias).

• from, to, days, weeks (opcional): a janela de datas

"O que está na minha agenda esta semana?"

get_my_tasks

Tarefas atribuídas ao usuário autenticado, com data de vencimento, prioridade e referência.

• include_done (opcional): incluir também tarefas concluídas

"Quais são minhas tarefas abertas?"

get_open_tasks

Todas as tarefas abertas da equipe, com responsáveis.

• reference (opcional): project, booking ou user

"Quais tarefas do projeto ainda estão abertas?"

get_staff_projects

Lista os projetos nos quais um membro da equipe está alocado, com intervalo de datas e duração.

• staff_name (obrigatório)

"Em quais projetos Karl está alocado?"

get_staff_collaborators

Mostra com quem um membro da equipe trabalhou, baseado em reservas compartilhadas.

• staff_name (obrigatório)

"Com quem Alexander trabalhou?"

get_staff_next_holiday

Obtém as próximas férias de um membro da equipe (início, fim, duração, comentário).

• staff_name (opcional; omita para o usuário autenticado)

"Quando são minhas próximas férias?" · "Quando Hendrikje está de férias?"

get_staff_holiday_quota

Obtém a cota de férias de um membro da equipe para um ano: total, dias usados e restantes.

• staff_name (opcional; omita para o usuário autenticado)
• year (opcional; padrão é o ano atual)

"Quantos dias de férias ainda tenho?"

get_project_stats

Estatísticas de reservas para um projeto: reservas passadas vs. futuras com detalhamento por status.

• project_name (obrigatório)

"Mostrar estatísticas de reservas para o Projeto Alpha"

get_project_team

Lista os membros da equipe que trabalharam em um projeto, com o número de reservas de cada um.

• project_name (obrigatório)

"Quem trabalhou no redesenho do site?"

get_project_tasks

Status das tarefas de um projeto: todas as tarefas do projeto e suas reservas, com um resumo de abertas/concluídas/atrasadas.

• project_name (obrigatório)

"Há tarefas abertas no projeto do documentário?"

get_invoices

Lista faturas com filtros e totais por moeda; paginado. Grupos de status: draft, open, overdue, paid, partially-paid, canceled, locked.

• search (opcional): corresponde a número, número do pedido, assunto, endereço do destinatário
• status, number, date_min/date_max, due_date_min/due_date_max, sum_min/sum_max, outstanding_min/outstanding_max, sort, order, page, per_page (opcional)

"Quais faturas estão vencidas?" · "Faturas abertas para Acme"

get_offers

Lista ofertas (orçamentos) com filtros e totais líquidos por moeda; paginado. Grupos de status: draft, locked, open, accepted, declined.

• search, status, number, date_min/date_max, sum_min/sum_max, sort, order, page, per_page (opcional)

"Mostrar ofertas recusadas deste ano"

get_orders

Lista pedidos (trabalhos) com suas ofertas e faturas conectadas em linha; paginado.

• search (opcional): corresponde ao número do pedido e nome
• status, number, date_min/date_max, sort, order, page, per_page (opcional)

"O que foi orçado e faturado no pedido 2026-014?"

search_docs

Pesquisa a documentação do freispace e retorna os trechos mais relevantes.

• query (obrigatório)
• limit (opcional): máximo de trechos, padrão 5

"Como configuro o planejamento de turnos no freispace?"

Tratamento de Erros

Erros são retornados ao modelo solicitante como mensagens curtas e acionáveis (ex.: Not found (404): Staff member with name 'X' not found. Call get_staffs to list valid staff names.). Diagnósticos são registrados em stderr; stdout transporta apenas o protocolo MCP.

⚠️ Aviso de Versão Beta

Nosso servidor MCP do freispace está atualmente em beta. Todos os recursos são gratuitos durante este período. Agradecemos seu feedback e paciência enquanto continuamos a melhorar a plataforma.

Licença

Licença MIT - veja o arquivo LICENSE para detalhes.

Suporte

Para suporte e dúvidas:

• Documentação: documentação do freispace
• Problemas: GitHub Issues
• Contato: Suporte freispace