MCP

MCP 서버는 Anyy에 외부 도구를 추가합니다. 서버마다 프로필 하나에 속합니다. 연결과 도구 노출을 구성한 뒤 저장하세요. Probe는 선택적 연결 검사이며 저장·활성화의 필수 조건이 아닙니다.

대화로 구성

특정 MCP 엔드포인트나 로컬 서버 명령을 Anyy에 주고 현재 프로필에 추가해 달라고 요청할 수 있습니다. 셸 도구가 있으면 기존 Anyy CLI를 사용합니다. MCP 구성은 별도 네이티브 모델 도구가 아닙니다. 대화와 Dashboard에 같은 프로필을 사용하세요. 명시적 CLI 프로필 경로가 필요하면 셸 HOME과 다를 수 있는 Anyy 프로필 경로를 사용합니다.

저장 후 페이지를 갱신해 Server ID, 활성 설정, 연결을 확인하세요. 이 페이지에서 직접 추가한 뒤 다음 대화 턴에서 사용을 요청해도 됩니다. codemode 노출은 Codemode로 검색·호출하고 deferred는 도구 검색을 사용합니다. 정의 저장, 이름 표시, 실제 원격 도구 호출은 별도 검사입니다. 구성이 저장되어도 연결 실패는 실패로 보존되어야 합니다.

Dashboard에서 서버 추가

Dashboard → MCP → Add MCP server를 엽니다.

1. 문자, 숫자, 하이픈, 밑줄로 안정적인 Server ID를 입력합니다.
2. 로컬 명령은 stdio, 원격 엔드포인트는 http를 선택합니다.
3. 명령과 인수 또는 MCP URL을 입력합니다.
4. 필요에 따라 공급자 인증, OAuth 옵션, 헤더, 환경 값을 설정합니다.
5. Exposure와 선택적 순서 있는 JSON 도구 재정의를 선택합니다.
6. Save를 선택합니다. 필요하면 Probe로 연결 결과를 봅니다.

로컬 명령은 Anyy 런타임의 운영체제 접근 권한으로 실행합니다. 일반 환경/헤더/OAuth 값은 입력 문자열을 그대로 유지합니다. Save는 필드 이름에서 비밀정보 참조를 추론하지 않습니다. Anyy 관리 비밀 값에는 명시적 참조를 사용하세요. 값 표현식을 참조하세요.

공유 연결은 MCP 관리자 시작 시 고정된 상주 워크스페이스 루트를 알립니다. 로컬 프로세스의 구성 작업 디렉터리는 이 루트와 별개입니다. 초기화, 루트, 작업 디렉터리 동작은 초기화와 워크스페이스 루트를 참조하세요.

연결 사전 요건

클라이언트 전송은 stdio와 Streamable HTTP(http)를 지원합니다. 별도 sse 전송은 거부하지만 HTTP가 Streamable HTTP의 일부로 이벤트 스트림을 전달할 수 있습니다. 루프백 HTTP URL 외의 원격 엔드포인트는 HTTPS여야 합니다.

stdio는 Anyy가 실행되는 컴퓨터에 서버 실행 파일과 의존성을 설치하세요. npx 명령에는 해당 호스트의 Node.js/npm이 필요합니다. Anyy가 런타임을 번들하거나 서버를 설치하지 않습니다. PATH와 HOME 등을 포함한 제한된 프로세스 환경만 상속합니다. 나머지 필수 값은 서버 env로 명시하세요. HTTP 서버에는 로컬 Node.js가 필요하지 않습니다.

설정과 프로필 정의

저장 프로필 정의와 유효 프로젝트 항목은 다른 파일에서 올 수 있습니다. 편집 전에 구성 출처를 확인하세요. 프로필·프로젝트 구성을 참조하세요.

활성화/비활성화는 기존 토글을 사용하세요. Edit에서 설정 작업을 선택하여 선택 출처 또는 기존 재정의에 Exposure만 저장하고 전송·정의 필드는 비우세요. 관련 없는 서버를 재연결하지 않습니다. 노출 변경은 선택 서버도 재연결하지 않습니다. 전송, 자격 증명, 설명, 순서 있는 도구 재정의는 별도 프로필 정의 작업을 사용하세요. 한 저장에서 두 작업을 합치지 마세요.

설정 저장 뒤 연결 오류가 나도 저장 설정은 취소되지 않습니다. mcp reload는 로드된 값을 재연결합니다. 수동 편집 파일을 다시 읽으려면 시작 또는 유휴 session.reload RPC가 필요하며 다른 연결 테스트로는 되지 않습니다.

도구 노출

값	동작
codemode	기본값. Codemode 검색으로 접근
deferred	도구 검색으로 발견
direct	모델에 직접 선언
hidden	모델·Codemode 검색에서 제외

toolExposure는 서버 기본값을 재정의합니다. 정확한 이름이 우선하며 그 외에는 처음 일치한 와일드카드 규칙이 적용되므로 객체 순서가 중요합니다.

{"search":"direct","read*":"deferred","*":"hidden"}

MCP 구성은 mcp-* 개인 도구 모음을 생성·활성화하지 않습니다. 일반 Anyy 개인 도구 모음과 상위 도구 제한은 별도입니다.

HTTP 인증

Authorization 헤더와 공급자 참조가 모두 없으면 Anyy는 필요할 때 원격 서버의 OAuth 흐름을 지원합니다. 공급자 참조는 JSON 객체입니다.

{"provider":"provider-id"}

OAuth 옵션도 별도 JSON 객체입니다. 예: {"clientId":"registered-client"}. 이전 auth: oauth, header, none 선택기는 허용하지 않습니다. 민감 헤더는 비밀정보 참조로 저장하고 URL에 자격 증명을 넣지 마세요.

서버 저장 후 상세 페이지에서 Sign in을 선택합니다. 인증 페이지를 여세요. 브라우저가 Anyy에 접근하지 못하면 전체 리디렉션 URL을 로그인 양식에 붙여 넣습니다. 취소하거나 페이지를 떠나면 대기 로그인을 중지합니다. CLI 대안은 anyy mcp login SERVER_ID --timeout 300입니다.

서버를 유지하고 로그아웃하려면 정확한 구성 ID로 anyy mcp logout SERVER_ID를 사용하세요. 자격 증명·캐시 동작은 로그아웃을 참조하세요. CLI 명령이며 추가 Dashboard 버튼이 아닙니다. 원시 프로필 정의를 제거하면 Anyy 관리 OAuth 자격 증명도 지웁니다. 프로젝트 정의는 프로젝트 CLI/파일 절차를 사용하세요. remove --local은 권한을 보존하고 구성 재읽기 후 적용됩니다. 모든 구성 변경에 기존 프로필 소유권과 자격 증명 보호가 적용됩니다.

상태와 도구

서버 설정은 활성 여부를 나타냅니다. 런타임 가용성은 연결됨, 대기, 저하, 사용 불가를 별도로 보고합니다. 점검 결과에는 각 도구의 name, visible_name, description, exposure, offered 사실을 담은 tools 인벤토리 하나가 있습니다. 이는 승인이나 허용 목록 결정이 아닙니다.

HTTP의 기본 OAuth 지원은 익명 서버에 로그인을 요구하지 않습니다. 연결 준비와 자격 증명 상태는 별개입니다. auth_mode: oauth는 준비 연결 및 not_loaded OAuth 자료와 공존할 수 있습니다. 처음부터 토큰이 없다는 사실만으로 재인증 요청은 아닙니다. 실제 서버 챌린지, 만료된 권한, 명시적 로그아웃은 정상 로그인·자격 증명 상태 동작을 유지합니다.

스키마와 설명은 도구를 여세요. 서버 페이지나 CLI에서 비밀정보가 가려진 진단 이벤트를 확인하세요.

리소스 기능은 공유 list_mcp_resources, list_mcp_resource_templates, read_mcp_resource 도구를 사용합니다. 상태는 resources_advertised, prompts_advertised, server_capabilities를 보고합니다. 이전 리소스/프롬프트 enabled, posture, count 필드와 구성 스위치는 폐기되었습니다. 입력, 노출, 출력 동작은 리소스와 템플릿을 참조하세요.

Codemode 또는 지연 검색으로 구성된 활성 서버는 제한된 mcp_servers 프롬프트 요약에도 표시됩니다. 구성 설명이 있으면 사용 가능한 서버 지침 첫 줄보다 우선합니다. 연결 중에도 목록에 나타날 수 있습니다. 직접 전용, 숨김 전용, 비활성 서버는 제외됩니다.

설명 저장이나 노출 변경은 활성 실행 프롬프트를 다시 쓰지 않습니다. 요약은 실행 시작 시 캡처되고 다음 프롬프트에 갱신됩니다. 서버 요약을 참조하세요.

CLI

anyy mcp add docs --command mcp-docs --exposure codemode
anyy mcp add remote --url https://example.com/mcp --auth '{"provider":"provider-id"}'
anyy mcp configure docs --exposure deferred
anyy mcp set docs description 'Documentation tools'
anyy mcp set docs toolExposure '{"read*":"deferred","*":"hidden"}'
anyy mcp test docs
anyy mcp status --json
anyy mcp show docs
# Only if the current docs server advertises this name and schema:
anyy mcp call docs.search --args '{"query":"Anyy"}'
anyy mcp disable docs
anyy mcp remove docs

add는 기본적으로 활성 지연 서버를 저장합니다. 비활성 저장에는 --disable을 사용하세요. 구성은 도구 선택 프롬프트를 수행하거나 연결 점검을 요구하지 않습니다.

이전 전역 mcp.client.enabled, tools.include, tools.exclude, tools.trusted, --include, --activate-toolset은 폐기되었으며 거부됩니다. 노출 필드로 업데이트하세요. RPC에서 순서 있는 재정의는 tool_exposure JSON 문자열로 전달되고 단일 순서 있는 toolExposure 구성 값이 됩니다.

문제 해결

문제	다음 조치
활성 서버가 사용 불가	로그 확인 후 anyy mcp test SERVER_ID
구성 거부	타입 필드 확인 및 폐기 선택기 제거
OAuth 조치 필요	anyy mcp login SERVER_ID
도구 누락	서버 활성 상태, 노출, 검색 도구 확인
로컬 프로세스 시작 불가	명령, 인수, 환경 확인