문서

실제로 쓰는 방법

새 팀이 첫날에 필요한 세 가지입니다. 여기 적힌 것은 모두 오늘 제공되는 제품에 대한 설명입니다.

에이전트란 무엇이고, 어떻게 요청합니까

에이전트는 하나의 객체를 대상으로 작성한 TypeScript입니다. 직접 쓸 필요는 없습니다. 채팅에서 할 일을 설명하면 Naski가 작성하고, 무엇이든 저장되기 전에 코드를 보여 줍니다.

1
무엇을 언제 해야 하는지 말합니다. “평일 아침 8시마다”, “폴더에 PDF가 들어오면”, “이 주소로 메일이 오면”. 일정과 트리거는 코드를 실행하지 않고 읽어 내므로, 고정된 값으로 적습니다.
2
저장하기 전에 무엇을 하는지 읽습니다. 코드가 곧 동작이며, 그 뒤에 숨은 것은 없습니다.
3
공간의 일부만 봐야 한다면 폴더를 지정합니다. 파일 도구는 그 하위 트리 안으로 제한됩니다.
4
작업 기록을 남기게 합니다. 에이전트는 한 일마다 평이한 한 줄을 진행 중 또는 완료로 표시해 적고, 다음 실행에서 다시 읽습니다. 긴 일이 짧은 실행 여러 번으로 쪼개져도 이어지는 이유입니다.
5
무엇이 사람을 거쳐야 하는지 정합니다. 승인을 요청하면 사람이 답할 때까지 실행이 멈추고, 침묵은 거절로 처리합니다. 검토로 넘기면 막지 않고 항목을 나중 처리 대기열에 둡니다.
6
에이전트를 수정하면 새 에이전트가 만들어지므로, 잘 돌던 버전은 되살릴 수 있습니다.

알아 둘 것에이전트에는 상시 네트워크 접근이 없습니다. 웹이든 사용자의 공간이든 연결된 도구든, 닿는 모든 것은 플랫폼이 대신 수행하는 이름 붙은 호출을 거칩니다.

커넥터는 코드가 아니라 데이터입니다. 기본 주소, 인증 형식, 작업 목록. Naski가 요청을 만들고 자격 증명을 서버 측에서 주입합니다.

1
설정 → 커넥터를 열고 카탈로그에서 설치합니다. 채팅에 설치를 부탁해도 됩니다.
2
제공업체가 사용 중인 환경에 등록되어 있으면, 연결을 누르고 제공업체 화면에서 승인합니다. 키는 어디에도 복사되지 않습니다.
3
그렇지 않으면 설정에 키를 붙여 넣습니다. 채팅 메시지에는 키를 붙여 넣지 마십시오. 키는 설정에 두는 것이며, 그곳에서 암호화되어 저장되고 서버 측에서 주입됩니다.
4
어떤 서비스는 회사 고유의 주소에 있습니다 — Salesforce, Zendesk, Jira, Confluence, Zoho CRM, Odoo, Shopify, DocuSign. 이들을 설치할 때는 인스턴스 URL을 묻고, 없으면 진행하지 않습니다.
5
바깥으로 나가는 호출은 HTTPS만 허용하며, 주소가 사설 또는 예약된 네트워크로 해석되면 거부합니다.
6
제공업체가 토큰 갱신을 거부하면 연결을 지우고 다시 연결하라고 알립니다. 모든 호출이 조용히 실패하도록 두지 않습니다.

알아 둘 것카탈로그에 없는 서비스에도 닿을 수 있습니다. 채팅이 같은 선언적 형식으로 커넥터를 작성할 수 있고, 원격 MCP 서버가 도구형 서비스를 맡습니다.

Naski는 자체 MCP 서버를 공개합니다. 그래서 Claude Code, Claude Desktop, ChatGPT 같은 클라이언트에서, 이미 일하고 있는 자리에서 에이전트를 조회하고 만들고 실행하고 살펴볼 수 있습니다.

1
설정 → MCP 서버를 엽니다. 엔드포인트가 그곳에 표시되며, 다음과 같습니다:
```
https://api.blackbox.finance/mcp
```
2
Claude Desktop과 ChatGPT는 OAuth로 연결합니다. 엔드포인트를 커넥터로 추가하고 승인하십시오. 복사할 토큰은 없습니다.

명령줄 클라이언트라면 설정에서 토큰을 만들고 다음을 실행합니다:

claude mcp add --transport http naski https://api.blackbox.finance/mcp --header "Authorization: Bearer YOUR_TOKEN"

알아 둘 것MCP 클라이언트가 보는 것은 사용하는 토큰의 계정 범위로 한정됩니다. 그 계정의 에이전트, 실행, 크레딧뿐이며 그 밖의 것은 없습니다.

무료 요금제에는 활성 에이전트 하나와 예약 실행 하나가 들어 있습니다. 누구도 서명하기 전에, 이 방식이 맞는지 보기에는 충분합니다.