What is MCP?
MCP, ou Model Context Protocol, é uma forma padronizada de clientes de IA se ligarem a produtos externos. Em vez de pedir a um assistente para adivinhar como o Ocoya funciona, você liga o assistente ao Ocoya MCP e ele pode descobrir ferramentas tipadas para as ações suportadas.
O Ocoya MCP expõe ferramentas de marca, publicação, marca, Studio e workflows depois de o utilizador aprovar o acesso por OAuth.
AI client connects
Claude, ChatGPT, Codex, VS Code ou outro cliente compatível com MCP liga-se a https://mcp.ocoya.com através de Streamable HTTP MCP.
User approves access
O Ocoya abre um fluxo de aprovação OAuth onde o utilizador inicia sessão, revê as permissões e seleciona as marcas a que o cliente pode aceder.
Ocoya tools become available
O cliente aprovado pode criar e gerir posts, agendar conteúdo, aplicar contexto de marca e executar workflows dentro das marcas selecionadas.
Why use MCP for Ocoya?
O MCP é útil quando você quer que um assistente de IA execute ações do produto de forma direta e segura:
- O assistente pode descobrir ferramentas do Ocoya em vez de inventar chamadas à API.
- Os utilizadores aprovam o acesso através de OAuth em vez de copiarem API keys.
- O acesso à marca é limitado às marcas selecionadas durante a aprovação.
- As chamadas de ferramentas devolvem dados estruturados que os clientes podem usar em ações posteriores.
What Ocoya exposes
O Ocoya MCP fornece aos clientes aprovados ferramentas para:
| Area | What the assistant can do |
|---|---|
| Account and brand | Identificar o utilizador autorizado e listar as marcas aprovadas. |
| Social profiles | Listar os canais ligados e iniciar novos fluxos de ligação social. |
| Posts | Criar, inspecionar, atualizar, agendar, publicar e eliminar grupos de posts. |
| AI drafts | Gerar rascunhos de posts editáveis a partir de prompts e contexto visual opcional. |
| Creative context | Listar bibliotecas de hashtags e templates do Studio. |
| Workflows | Listar, inspecionar, ativar, desativar e executar workflows. |
Authentication model
O Ocoya MCP utiliza OAuth. Um cliente não pode usar o Ocoya MCP com uma Ocoya API key.
Quando o cliente precisa de uma ferramenta do Ocoya pela primeira vez, abre o Ocoya no browser. O utilizador inicia sessão, revê as permissões pedidas, seleciona as marcas permitidas e aprova o cliente.
O cliente recebe um access token de curta duração e pode renovar o acesso de acordo com o fluxo OAuth. Se uma marca não tiver sido selecionada durante a aprovação, as ferramentas não podem aceder a essa marca.
MCP vs REST API
Use MCP quando um cliente de IA deve agir em nome do utilizador através de linguagem natural e chamadas de ferramentas.
Use a REST API quando estiver a criar uma integração de backend, um job agendado ou uma aplicação que chama endpoints do Ocoya diretamente.