MCP

MCP

Ligue o Claude, o Cursor, o VS Code, o ChatGPT ou o Grok para marcar e detetar ficheiros num espaço que lhe pertence.

Cole o URL do conector num cliente que fale MCP por Streamable HTTP. Não há chave de API nem uma CLI de ficheiros. O Markedfile inicia sessão com a mesma conta, incluindo SSO e um autenticador, e pergunta qual espaço a aplicação pode usar.

Configurar uma ligação

  1. 1Adicione um servidor MCP no cliente e escolha Streamable HTTP, por vezes chamado HTTP.
  2. 2Cole https://markedfile.com/api/mcp. Os excertos abaixo são o sítio habitual onde cada cliente guarda esse URL.
  3. 3Conclua o início de sessão no navegador e escolha o espaço.
  4. 4Permita marcar e detetar. Pode revogar a ligação mais tarde nas definições do espaço.

Como funciona o início de sessão

A ligação usa OAuth 2.1 com PKCE (S256). Aprova um espaço. O cliente não vê a sua palavra-passe.

  1. 1O cliente regista-se sozinho e envia um desafio de código.
  2. 2O navegador abre o início de sessão do Markedfile. O SSO e o autenticador são os que a conta já usa.
  3. 3Escolhe um espaço que lhe pertence e permite marcar, detetar ou ambos.
  4. 4O Markedfile devolve um código de utilização única ao endereço de retorno registado. O cliente troca-o por um token de acesso.
  5. 5O token de acesso dura uma hora e só é guardado como hash. O token de atualização muda em cada uso.
  6. 6O token só pode marcar e detetar no espaço que escolheu. Um ficheiro marcado noutro espaço não é resolvido.
  7. 7Revogar a ligação invalida os tokens de imediato.

Configuração do cliente

Use Streamable HTTP. Prefira file_url quando o ficheiro já é público. Caso contrário, chame create_upload_url, envie os bytes em bruto com PUT ou POST e passe file_id. Use file_base64 só para um ficheiro muito pequeno, cerca de 100 KB.

Claude

  1. Em claude.ai, abra Definições, depois Conectores, e adicione um conector personalizado. No Claude Desktop, abra Definições, depois Conectores, e adicione um conector personalizado.
  2. Cole o URL do conector. Deixe o cliente concluir o início de sessão no navegador.
  3. Inicie sessão no Markedfile, com SSO ou autenticador se a conta os usar, e escolha o espaço.

Claude

https://markedfile.com/api/mcp

Cursor

  1. Abra as definições do Cursor, depois MCP, e adicione um servidor. Também pode acrescentar o JSON abaixo à configuração de MCP.
  2. Escolha Streamable HTTP e cole o URL do conector.
  3. Conclua o início de sessão no navegador e escolha o espaço. O Cursor guarda o token de atualização localmente.

Cursor

{
  "mcpServers": {
    "markedfile": {
      "url": "https://markedfile.com/api/mcp"
    }
  }
}

VS Code

  1. No VS Code, execute MCP: Add Server na paleta de comandos, ou adicione o JSON abaixo em mcp.json.
  2. Defina o tipo como http e o URL como o do conector.
  3. Conclua o início de sessão no navegador e escolha o espaço.

VS Code

{
  "servers": {
    "markedfile": {
      "type": "http",
      "url": "https://markedfile.com/api/mcp"
    }
  }
}

ChatGPT

  1. No ChatGPT, abra Definições e depois Conectores. O modo de programador também pode adicionar um conector ou uma app personalizada.
  2. Adicione o URL do conector e inicie a sessão.
  3. Inicie sessão no Markedfile e escolha o espaço.

ChatGPT

https://markedfile.com/api/mcp

Grok Bot

  1. No Grok Bot, peça ao seu bot no chat para adicionar um conector com o URL abaixo.
  2. Autorize a sua conta Markedfile no ecrã OAuth que abrir.

Grok Bot

https://markedfile.com/api/mcp

Ferramentas

create_upload_url
Cria um URL de envio de curta duração para o espaço ligado. Envie os bytes em bruto do ficheiro para upload_url com PUT ou POST. O curl pode usar --upload-file ou --data-binary. Depois passe file_id a mark_file ou detect_file. O URL dura cerca de 15 minutos. max_bytes é o limite do plano do espaço, incluindo vídeo. Isto não marca o ficheiro e não usa uma vaga de ficheiro ativo.
mark_file
Marca um ficheiro para um destinatário no espaço ligado. Prefira file_id de create_upload_url, ou file_url quando o ficheiro já é público. Envie file_base64 só para um ficheiro muito pequeno, cerca de 100 KB. Envie exatamente um de file_id, file_url ou file_base64. recipient ou label é o identificador (1–32 caracteres, sem caracteres de controlo). O ficheiro marcado volta como download_url, uma ligação de curta duração. Defina inline_base64 como true só quando o ficheiro marcado tem cerca de 100 KB ou menos e os bytes têm de estar no resultado. Um vídeo entra na fila: o resultado é um id de tarefa e statusUrl, não os bytes marcados.
detect_file
Verifica um ficheiro contra o espaço ligado. Prefira file_id de create_upload_url, ou file_url quando o ficheiro já é público. Envie file_base64 só para um ficheiro muito pequeno, cerca de 100 KB. Envie exatamente um de file_id, file_url ou file_base64. Devolve o identificador do destinatário quando a marca pertence a esse espaço. Um vídeo entra na fila: consulte statusUrl até result aparecer. Uma captura de um fotograma não é detetada como imagem.

Limites

Marcar permite 40 pedidos por minuto, detetar 80 e create_upload_url 30, para a conta. O tamanho do ficheiro, as páginas do PDF e o vídeo seguem o plano do espaço. Um URL de envio expira em cerca de 15 minutos e o URL de descarga do ficheiro marcado expira em cerca de uma hora. Nenhum dos dois é um ficheiro ativo.