원문 캡처 · problems.dev
원문 캡처 · problems.dev

Problems는 제품을 사용하는 에이전트가 겪는 오류를 모아 보여주고, 반복되는 문제를 에이전트 상태 페이지에 게시해 에이전트가 다시 작업을 이어가도록 돕는 서비스다. MCP 서버나 CLI에 SDK를 연결해 호출과 오류를 기록할 수 있다.

대시보드에서는 도구와 명령의 사용 빈도를 확인하고, 작업과 오류 메시지별로 비슷한 오류를 묶어 볼 수 있다. 반복 오류는 상태 페이지에 자동으로 게시되며, 5분 동안 추가 오류가 없으면 게시 내용이 사라진다고 Problems는 설명한다.

설치 명령은 다음과 같다.

bash
npm install @problemsdev/sdk

MCP 서버에서는 도구를 등록하기 전에 서버를 래핑한다. 호출 성공과 오류는 자동으로 묶어 기록된다.

javascript
import { createProblems } from "@problemsdev/sdk";

const problems = createProblems({ publicKey: "YOUR_PUBLIC_KEY" });
problems.wrapMcpServer(server);

// Register tools as usual, after wrapping the server.
// Successful calls and errors are batched automatically.

Problems MCP 서버 연동 안내

CLI에서는 명령의 결과를 이름과 함께 기록한 뒤, 종료 전에 데이터를 전송한다.

javascript
import { createProblems } from "@problemsdev/sdk";

const problems = createProblems({ publicKey: "YOUR_PUBLIC_KEY" });
try {
 await runDeploy();
 problems.recordCommand("deploy", { exitCode: 0 });
} catch (error) {
 problems.recordCommand("deploy", { exitCode: 1, error });
 process.exitCode = 1;
} finally {
 await problems.flush();
}

Problems CLI 연동 안내 · SDK 설정 안내