Serviços disponíveis no MCP da Biah
Uma integração de mensagens autenticada pode consultar dados e executar ações que o cliente já tem permissão para realizar no portal da Biah.
O acesso depende de um telefone verificado, vínculo ativo, perfil autorizado e coworking selecionado. Toda ação que altera dados ou inicia um pagamento exige confirmação explícita vinculada à chamada.
O que o serviço oferece
Conta e contexto
Identifique os coworkings vinculados ao telefone verificado e consulte o cadastro do cliente no contexto selecionado.
Agenda, espaços e reservas
Consulte a agenda, encontre recursos disponíveis, veja preços e acompanhe reservas. Também é possível confirmar, remarcar e cancelar conforme as regras do portal.
Day pass
Quando o recurso estiver habilitado, clientes individuais podem ver planos, solicitar uma diária, iniciar o pagamento e acompanhar seu estado.
Cobranças e contratos
Consulte cobranças mensais e contratos publicados. O conteúdo financeiro e os downloads seguem as permissões do perfil.
Acesso da empresa
Consulte funcionários e eventos de acesso. Administradores de contato podem convidar pessoas, alterar papéis e gerenciar telefones.
Conta individual
Consulte identidade, saldo de uso e telefones cadastrados. O cliente também pode atualizar o CPF e cadastrar novos números.
Catálogo de ferramentas
As 40 ferramentas abaixo representam todas as ações possíveis. Para obter a lista efetiva de uma pessoa, a integração deve chamar tools/list no endpoint privado /mcp. O resultado respeita o perfil e os recursos habilitados.
| Ferramenta | O que permite fazer | Quem pode usar | Confirmação |
|---|---|---|---|
list_customer_contexts | Lista os coworkings em que o telefone verificado tem vínculo ativo, para selecionar o contexto correto antes das demais ações. | Clientes identificados | Não |
get_customer_profile | Consulta o cadastro do cliente no coworking selecionado. Dados fiscais aparecem somente quando o perfil tem permissão. | Clientes identificados | Não |
get_customer_agenda | Mostra a agenda do cliente no período informado, incluindo suas reservas e a ocupação exibida pelo portal. | Clientes identificados | Não |
list_reservation_resources | Lista salas e outros recursos que o cliente pode reservar, com filtro opcional por unidade. | Clientes identificados | Não |
search_available_resources | Busca recursos disponíveis no intervalo desejado, com filtros opcionais por unidade e tipo de recurso. | Clientes identificados | Não |
quote_reservation | Cria uma cotação temporária para reservar um recurso em determinado horário, aplicando preço e regras atuais. Exige confirmação. | Clientes identificados | Sim |
confirm_reservation | Efetiva a reserva a partir de uma cotação aceita, do preço confirmado e de uma chave de idempotência. Exige confirmação. | Clientes identificados | Sim |
list_reservations | Lista as reservas do cliente ou da empresa selecionada, conforme as permissões do perfil. | Clientes identificados | Não |
get_reservation | Mostra os detalhes de uma reserva específica que o perfil pode consultar. | Clientes identificados | Não |
quote_reschedule | Cria uma proposta para alterar o horário ou o recurso de uma reserva, com as condições atuais. Exige confirmação. | Clientes identificados | Sim |
confirm_reschedule | Aplica a remarcação previamente cotada, com preço aceito quando necessário. Exige confirmação. | Clientes identificados | Sim |
preview_reservation_cancellation | Mostra as condições e os efeitos previstos do cancelamento antes de alterar a reserva. | Clientes identificados | Não |
cancel_reservation | Cancela uma reserva permitida pelas regras atuais, usando uma chave de idempotência. Exige confirmação. | Clientes identificados | Sim |
list_reservation_events | Consulta o histórico de eventos de uma reserva, como criação, remarcação e cancelamento. | Clientes identificados | Não |
list_day_pass_plans | Lista os planos de day pass disponíveis para clientes individuais quando o recurso estiver habilitado.Disponível somente quando o recurso de day pass estiver habilitado. | Clientes individuais | Não |
request_day_pass | Cria um pedido de day pass para o plano e a data escolhidos; o pagamento ocorre em etapa posterior. Exige confirmação.Disponível somente quando o recurso de day pass estiver habilitado. | Clientes individuais | Sim |
list_day_pass_requests | Lista os pedidos de day pass do cliente individual e seus estados atuais.Disponível somente quando o recurso de day pass estiver habilitado. | Clientes individuais | Não |
get_day_pass_request | Mostra os detalhes de um pedido de day pass, incluindo a situação do pagamento.Disponível somente quando o recurso de day pass estiver habilitado. | Clientes individuais | Não |
start_day_pass_checkout | Inicia o checkout de um pedido de day pass e devolve as informações para continuar o pagamento. Exige confirmação.Disponível somente quando o recurso de day pass estiver habilitado. | Clientes individuais | Sim |
reconcile_day_pass | Solicita a atualização da situação de pagamento de um pedido de day pass. Exige confirmação.Disponível somente quando o recurso de day pass estiver habilitado. | Clientes individuais | Sim |
get_company_bill | Consulta a cobrança mensal de uma empresa cliente, com valores e itens acessíveis aos contatos autorizados. | Administradores e contatos da empresa | Não |
get_individual_bill | Consulta a cobrança mensal do cliente individual, incluindo os valores e itens do período informado. | Clientes individuais | Não |
list_published_contracts | Lista os contratos publicados que o perfil selecionado pode consultar. Rascunhos não aparecem. | Contatos autorizados e clientes individuais | Não |
get_contract_download_context | Obtém as informações de acesso para baixar um contrato publicado e autorizado. | Contatos autorizados e clientes individuais | Não |
get_employee_identity | Mostra o vínculo do funcionário com a empresa cliente e o papel que define suas permissões. | Funcionários de empresas clientes | Não |
get_company_allowance | Consulta o saldo de uso incluído da empresa no período informado ou no período atual. | Funcionários de empresas clientes | Não |
list_company_employees | Lista os funcionários vinculados à empresa, seus papéis e a situação do acesso. | Administradores de contato da empresa | Não |
invite_company_employee | Convida um funcionário por e-mail e define seu papel inicial na empresa. Exige confirmação. | Administradores de contato da empresa | Sim |
change_employee_role | Altera o papel de um funcionário e as permissões associadas na empresa. Exige confirmação. | Administradores de contato da empresa | Sim |
revoke_company_employee | Revoga o acesso de um funcionário à empresa cliente. Exige confirmação. | Administradores de contato da empresa | Sim |
list_company_access_events | Consulta o histórico de eventos de acesso da empresa, como convites e alterações de vínculo. | Administradores de contato da empresa | Não |
list_company_phones | Lista os números de telefone associados aos funcionários da empresa e sua situação de verificação. | Administradores de contato da empresa | Não |
register_employee_phones | Cadastra um ou mais números de telefone para um funcionário; a verificação segue o fluxo da Biah. Exige confirmação. | Administradores de contato da empresa | Sim |
revoke_employee_phone | Revoga um número de telefone vinculado a um funcionário da empresa. Exige confirmação. | Administradores de contato da empresa | Sim |
get_individual_identity | Mostra o cadastro e o vínculo ativo do cliente individual no coworking selecionado. | Clientes individuais | Não |
update_individual_tax_identity | Atualiza o CPF usado na identificação fiscal do cliente individual. Exige confirmação. | Clientes individuais | Sim |
list_individual_phones | Lista os números de telefone cadastrados para o cliente individual e sua situação de verificação. | Clientes individuais | Não |
register_individual_phones | Cadastra um ou mais números pessoais; a verificação segue o fluxo da Biah. Exige confirmação. | Clientes individuais | Sim |
get_individual_allowance | Consulta o saldo de uso incluído do cliente individual no período informado ou no período atual. | Clientes individuais | Não |
read_published_contract_chunk | Lê um trecho de até 256 KiB de um contrato publicado e autorizado, em base64, para permitir o download em partes. | Contatos autorizados e clientes individuais | Não |