로컬 MCP 도구 오류 해결하기

검증된 Linux x86_64용 Altifigence CLI 번들의 로컬 XLS 연결에서 다음 항목을 확인하세요.

서버 프로세스 확인하기

MCP 클라이언트의 stdio 설정에서 설치된 alti-mcp 실행 파일의 절대 경로를 사용하고 인수 목록은 비워 두세요. 서버 프로세스의 환경 변수 ALTI_MCP_MODE를 local-xls로 설정하세요. 검증된 설치 폴더에서 alti-xls를 alti-mcp와 함께 두세요. 설정 절차는 MCP로 로컬 XLS 도구 사용하기를 따르세요.

도구 호출 확인하기

Unknown tool in local XLS mode.가 나오면 연결의 도구 목록을 새로 고치고 반환된 정확한 이름을 사용하세요. altifigence.local.xls.capabilities를 {}로 호출해 설치된 엔진의 기능을 확인하세요.

JSON-RPC 코드 -32601과 함께 Method not found: …가 나오면 메서드를 tools/call로 지정하고 params.name에 도구 이름을 넣어 호출하세요.

Capabilities accepts no arguments.가 나오면 인수로 {}를 사용하세요. Unsupported local XLS argument.가 나오면 해당 도구의 입력 스키마에 있는 필드를 사용하세요.

실행 기록 읽기

도구가 실행 기록을 반환하면 structuredContent의 receipt.status, receipt.exitCode, receipt.stderr와 engine을 확인하세요.