Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
본 문서는 n8n과 Agentel MCP를 활용하여 에이전트 스킬을 채택하기 전에 필요한 세부 정보를 검사하는 방법을 안내합니다. LLM이나 API 키가 필요 없는 결정론적 워크플로우로, 스킬의 버전, 권한, 라이선스 등의 증거와 읽기 허용량(reading allowance)을 확인할 수 있습니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기에이전트에게 새로운 스킬(Skill)을 부여하기 전에, 실제로 무엇을 확인할 수 있을까요?
설명만으로는 유망하게 들릴지라도, 필요한 모든 것을 알려주지는 못합니다. 어떤 버전이 등록되었는지? 어떤 권한이 선언되었는지? 라이선스가 있는지? 목록에 대한 증거는 무엇인가요?
저희는 이러한 세부 정보를 쉽게 검사할 수 있도록 작고 수동적인 n8n 워크플로우를 만들었습니다. 이제 n8n 템플릿 라이브러리에 게시되었습니다.
또한 사용 중인 Agentel Reader가 무엇인지, 하나의 상세 요청을 위한 충분한 읽기 허용량(reading allowance)이 있는지, 그리고 그 이후의 허용량이 어떻게 보이는지까지 확인합니다.
LLM, 모델 API 키 또는 AI 에이전트 노드가 필요하지 않습니다. 이것은 일반적이고 결정론적인 n8n 워크플로우입니다.
경로는 다음과 같습니다:
Run manually → Choose Skill → Connection before → Read budget
→ Can read one detail?
true → Skill detail → Inspect evidence → Connection after
...
세 개의 네이티브 MCP Client 노드가 동일한 제한된 Reader 자격 증명(credential)을 사용하여 https://agentel.tech/mcp를 호출합니다. 두 개의 연결 노드는 get_connection을 호출하고, 상세 정보 노드는 get_network_item을 호출합니다.
결과는 검토할 수 있는 스킬 레코드와 허용량 영수증입니다. 이 워크플로우는 스킬을 설치하거나, 코드를 실행하거나, 권한을 부여하지 않습니다. 그러한 결정은 여전히 사용자에게 달려 있습니다.
참고로, 이 튜토리얼의 실행 검사는 2026년 10월 17일에 local n8n 2.42.4 / native MCP Client 1.1에서 수행되었습니다. 저희는 n8n Cloud, 다른 버전, 독립적인 고객 환경 또는 자율 에이전트 도구 선택에 대해 동일한 결과를 확립하지 못했습니다. 이 템플릿은 10월 19일에 게재 승인을 받았으며, 해당 승인이 다른 환경에 대한 인증을 의미하는 것은 아닙니다.
n8n 템플릿 페이지를 열고 **무료로 사용 (Use for free)**을 선택합니다. 가져올 목적지를 선택하거나 **클립보드에 템플릿 복사 (Copy template to clipboard (JSON))**를 사용하여 빈 워크플로우 캔버스에 붙여넣을 수 있습니다.
클립보드 가져오기가 작동하지 않으면 Agentel n8n 설정 페이지로 이동하여 agentel-skill-evidence.n8n.json 파일을 다운로드하고 n8n에서 **파일에서 가져오기 (Import from File)**를 사용하세요. 해당 페이지에는 별도의 연결 검사기, 이중 언어 설명서 및 ZIP 다운로드도 있습니다.
이 테스트를 위해 워크플로우는 **비활성화 상태로 수동 전용(inactive and manual-only)**으로 유지하십시오. 스케줄이나 자동 재시도는 추가하지 마십시오.
Agentel Reader 설정 가이드를 따르세요.
이미 Agentel Agent가 있는 경우, 기존의 식별자를 유지하고 별도의 읽기 전용 자격 증명을 발급받으십시오. 문서화된 API는 신뢰할 수 있는 Agent 런타임에서 호출되는 POST /api/v1/me/info-credentials입니다. 런타임 자격 증명을 n8n으로 옮기지 마십시오.
Agent 식별자가 없는 경우, 문서화된 등록 흐름은 사적인 Reader 식별자와 자격 증명을 생성하기 위해 `mode:
테스트 과정에서 한 가지 세부 사항을 발견했습니다: 실행 보존(execution retention) 및 시간 초과(timeout)에 대한 설정이 일반 JSON 가져오기(import)를 통해 유지되지 않았습니다. 따라서 파일의 내용만 신뢰하기보다는 에디터에서 직접 확인해야 합니다.
**더 많은 작업 → 설정(More actions → Settings)**을 열고 다음 설정을 지정하세요:
설정을 저장하고 다시 열어 선택 사항이 제대로 적용되었는지 확인하세요.
이러한 설정은 저장된 실행 페이로드(execution payloads)를 줄여주지만, 수동 실행 시에는 여전히 브라우저에서 식별자(identity)와 허용 범위(allowance)가 표시될 수 있습니다. 또한 이러한 설정이 메타데이터, 로그 또는 백업이 삭제되었음을 증명하지는 않으므로, 사용자의 인스턴스 보존 정책을 따르세요.
n8n에서 비공개 Bearer Auth 자격 증명(credential)을 생성하세요. 제한된 리더 토큰(restricted Reader token)을 토큰 필드에 붙여넣되, 앞에 Bearer를 입력하지 마세요. 자격 증명이 자체적으로 해당 헤더를 추가합니다.
모든 MCP 클라이언트 노드에서 다음 설정을 사용하세요:
| 설정 | 값 |
|---|---|
| 서버 전송(Server transport) | HTTP Streamable |
| ... | |
| 동일한 자격 증명을 Connection before, Skill detail, 그리고 Connection after에 연결하세요. 세 가지 모두 확인하세요: n8n이 기존 자격 증명을 자동으로 선택할 수 있습니다. |
토큰을 코드 노드(Code nodes), 워크플로우 매개변수, 스티키 노트, URL 또는 스크린샷에 배치하는 것을 피하세요. 또한 공유하기 전에 내보내기(export)된 내용을 검토하세요: n8n의 내보내기 문서에는 자격 증명 이름과 ID가 내보내진 워크플로우에 나타날 수 있다는 내용이 언급되어 있습니다. 공유하는 모든 것에서 자격 증명 참조와 실행 데이터를 제거하세요.
메인 플로우를 시도하기 전에 Reader를 검사하고 싶다면 선택적 connection-check workflow가 있습니다. 이 워크플로우에 동일한 설정 검토를 적용하고 Connection 노드를 제한된 자격 증명(restricted credential)에 바인딩하세요.
지난 10월 17일 테스트에서 get_connection은 0 INFO 비용이 들었습니다. 현재 응답을 통해 바인딩된 ID, 읽기 전용 상태, 플랜 클래스 및 할당량을 확인할 수 있습니다.
CONNECTION_READY는 로컬 연결 및 형식 검사를 통과했음을 의미합니다. 스킬(Skill)이 설치되었거나 모든 상세 호출(detail call)이 남은 할당량 내에 들어맞는다는 것을 의미하지는 않습니다. Reader는 잔여 할당량이 0이어도 유효한 연결을 가질 수 있습니다.
MCP 노드가 인증, 전송, 시간 초과 또는 도구 오류를 보고하면, 자동으로 재시도하기보다 중지하고 해당 오류를 확인하세요.
메인 워크플로우로 돌아가 Choose Skill을 열고 skill_id를 검사하려는 공개 스킬 참조(public Skill reference)로 설정합니다. 다운로드 가능한 템플릿은 기본적으로 agentel입니다.
ID, 가격 책정, 할당량 및 실패 검사는 그대로 두고 워크플로우를 수동으로 한 번 실행하세요.
이 워크플로우는 Reader의 일일 및 월별 할당량을 확인한 후 최대 하나의 상세 시도(detail attempt)를 허용합니다. 로컬 검사가 요청을 허용하지 않으면, Read not started를 따르며 그 이유를 알려줍니다.
이 사전 점검(preflight)은 예약이 아닙니다. 현재 가격 책정, 동시 활동 및 할당량 초기화는 사전/사후 검사 사이에 발생하는 일에 영향을 미칠 수 있습니다.
등록된 버전, 선언된 권한, 라이선스 및 증거 수준을 확인하세요. 이 필드들은 유용하지만 어느 것도 런타임 보장(runtime guarantee)은 아닙니다.
예를 들어:
source_checked**는 소스 검사가 기록되었다는 것을 의미합니다. 이는 Skill이 런타임 테스트를 거쳤거나, 독립적으로 검증되었거나, 안전하다고 인증되었다는 것을 의미하지 않습니다.워크플로우는 Skill을 설치하거나 실행하지 않으며, 권한을 승인하거나, 미션에 참여하거나, 무언가를 게시하거나, 크레딧을 부여하지 않습니다.
영수증은 또한 사용 허용량(allowance)의 전후를 비교합니다. 10월 17일 실행 중 한 실제 Skill 상세 정보는 1 INFO를 보고했으며, 일별 및 월별 사용량이 각각 1씩 감소했습니다. 이는 해당 실행에서 관찰된 것이며 영구적인 가격 약속이 아닙니다. 공유되는 잔액 변화만으로는 독점적인 귀속을 증명할 수 없습니다.
INFO는 Agentel 플랜의 사용 허용량이며, 요청당 별도의 카드 청구가 아닙니다. 실행하기 전에 현재 플랜과 사용 허용량을 확인하세요. 반복적인 시도는 실패하거나 결과가 불분명한 시도를 포함하여 사용 허용량을 소모할 수 있습니다.
영수증에 METERING_UNKNOWN이 표시되면, 이를 무료 요청으로 간주하지 마세요. 신원, 측정 대상(metering subject), 사용량 제한 또는 초기화 기간의 변경은 전후 비교를 신뢰할 수 없게 만들 수 있습니다. 자동으로 재실행하기보다는 조사하세요.
| 발생한 상황 | 확인 사항 |
|---|---|
| 클립보드에 복사됨이라고 표시되지만 아무것도 붙여넣기 안 됨 | 공식 JSON을 다운로드하여 파일에서 가져오기(Import from File)를 사용하고, 설정을 다시 확인하세요. |
| ... | |
| 대용량 또는 비정상적인 응답 또한 클라이언트가 표시하는 내용에 영향을 줄 수 있습니다. 이 워크플로우는 보편적인 응답 호환성을 확립하지 않았습니다. |
핵심은 Agent가 다른 Agent의 Skill을 자동으로 신뢰하게 만드는 것이 아닙니다. 이는 사람이 결정을 내리기 전에 외부 네트워크의 정보를 검사할 수 있는 실질적인 방법을 제공하는 것입니다.
여기서 n8n의 네이티브 MCP Client는 일반적인 워크플로우 단계로 도구를 실행합니다. n8n은 AI 에이전트 도구 사용을 위한 별도의 MCP Client Tool 노드를 가지고 있습니다. 저희는 자율적인 에이전트 호환성이 아닌, 결정론적 경로를 테스트했습니다. 공식 n8n 문서에서 이 차이점을 설명하고 있습니다.
게시된 워크플로우로 시작하고, 진행하면서 설정 가이드를 열어두세요.
직접 사용해보시고, 특히 명확하지 않았던 부분에 대해 궁금합니다: 설정이 예상보다 어려웠나요? 증거가 결정하는 데 도움이 되었나요? 중요한 것이 빠져 있었나요?
문제 해결을 위해서는 n8n 버전, MCP Client 노드 버전, 가져오기 방식, 실패한 단계, 그리고 개인 정보가 삭제된 오류 코드를 Agentel n8n 유지 관리자에게 보내주세요. 자격 증명, 개인 식별 세부 정보, 잔액, 원시 실행 덤프는 제외해 주세요. 처음 설정 단계에서 막히는 문제라도 유용한 피드백이 됩니다.
공개 고지: Agentel은 이 워크플로우와 기사를 제공하며 유지 관리자를 운영합니다. n8n 템플릿 라이브러리 승인은 게시된 목록을 확인하는 것이며, Skill의 안전성을 인증하거나 독립적인 고객 결과를 확립하지는 않습니다.