Preparar Integração MCP

Receba um link de entrada ou um resumo do fornecedor através de duas fases separadas: um PR de pesquisa revisável em paperclip-content, depois a implementação do conector no Paperclip App somente após um humano aceitar a revisão exata da pesquisa e o conjunto de conexões.

Preserve Estes Limites

• Trate paperclip-content/integrations/README.md como o contrato de pesquisa e paperclip-content/integrations/skills/integration-harness/SKILL.md como seu ponto de entrada. Referencie e execute-os; não copie seus esquemas, templates, máquinas de estado, regras de reconciliação ou portões internos para esta skill.
• Trate paperclip/doc/connections/CONNECTOR-PLAYBOOK.md no branch de destino da implementação como o contrato do conector. Siga-o do início ao fim; não substitua o comportamento lembrado ou os exemplos nesta skill.
• Conclua a Fase A com um PR apenas de pesquisa. Não crie um branch de implementação do App, tarefa ou alteração de código antes que o portão de pesquisa seja aceito.
• Vincule a aceitação a um SHA de cabeça de PR de pesquisa e a um conjunto de conexões explícito. A aceitação não cobre commits posteriores ou conexões adicionais.
• Crie um PR do Paperclip App por conexão aprovada. Infraestrutura pré-requisito compartilhada ou correções amplas de playbooks podem usar PRs pré-requisitos separados; nunca combine conexões distintas em um único PR de conector.
• Mantenha as credenciais do fornecedor em armazenamento secreto aprovado. Nunca coloque segredos em resumos, arquivos de catálogo, texto de issue, planos, fixtures, screenshots, logs, nomes de branches, commits ou PRs.

Experiência de Conexão Padrão

• Solicite as permissões e escopos mais amplos que a conexão pode suportar por padrão. Os operadores não devem ter que prever todas as ferramentas futuras que podem precisar durante a configuração. Aplique o uso seguro após a conexão através do catálogo de ações do Paperclip, limites de recursos, políticas de "perguntar primeiro", quarentena e controles de auditoria.
• Mantenha o assistente padrão limitado às informações mínimas necessárias para criar uma conexão funcional: identidade da conexão, autenticação e qualquer limite de tenant ou recurso inevitável. Coloque a redução de escopo opcional, grupos de recursos, filtros de ferramentas individuais, modos de resposta, ajuste de transporte e outros controles de especialista atrás de uma divulgação Avançada colapsada.
• Forneça aos controles avançados padrões amplos e funcionais para que um operador possa concluir a configuração sem abri-los. Quando um provedor realmente exigir uma escolha avançada explícita, documente a exceção e explique-a em linguagem clara em vez de expor detalhes do protocolo por padrão.
• Trate a amplitude de permissão do fornecedor e a governança de execução do Paperclip como camadas separadas. Não reduza as permissões solicitadas do fornecedor apenas para substituir a falta de revisão de ação, aprovação, quarentena ou política de auditoria.

Preflight

1. Carregue a skill atual do Paperclip para checkout, comentários, interações, estado durável e disposição final. Carregue a skill padrão de preparação de PR (prepare-paperclip-pr para agentes do Paperclip) antes de abrir qualquer PR.
2. Resolva os URLs de entrada, fornecedor/plataforma, endpoint ou API MCP pretendido, repositórios e branches de destino, e a issue do Paperclip que possui o trabalho. Pergunte apenas quando estes não puderem ser determinados com segurança a partir do resumo.
3. Busque ambos os repositórios e registre os hashes de commit de destino. Leia os arquivos canônicos desses commits de destino, não de uma árvore de trabalho possivelmente desatualizada. Atualize e releia-os novamente imediatamente antes da Fase B.
4. Inventarie as entidades existentes no catálogo de integração, PRs abertos, branches e AppDefinitions/conectores atuais antes de criar qualquer coisa. Combine por significado, não por título ou slug.
5. Determine se a entrada descreve uma conexão ou várias. Uma conexão tem um proprietário de credencial coerente, endpoint/transporte, limite de recurso e catálogo de ações independentemente revisável. Registre a divisão proposta cedo e refine-a à medida que as evidências chegam.
6. Prefira documentação oficial do fornecedor, fontes de protocolo/RFC, sondas ao vivo seguras e código atual do Paperclip. Use fontes de terceiros apenas para encontrar ou qualificar evidências primárias. Registre cada afirmação factual com URL e data de acesso; marque fatos não resolvidos explicitamente em vez de adivinhar.

Não modifique uma conta de fornecedor, registre um cliente, conceda consentimento ou invoque uma ferramenta de escrita meramente para pesquisá-la. Uma sonda de metadados não autenticada e segura é permitida quando não altera o estado do fornecedor. Roteie a validação dependente de credencial ou navegador através de uma tarefa de QA explícita quando se tornar necessária.

Mantenha a Execução Resumível

…