AJEMS MCP 커넥터

Claude와 ChatGPT가 누구도 AJEMS에 로그인하지 않고도 AJEMS 워크스페이스에 대한 질문에 답하고 — 선택적으로 앱, 폼, 레코드를 생성할 수 있게 해줍니다.

하나의 배포로 모든 테넌트를 지원합니다. 사용자는 조직 이름과 AJEMS 비밀 키로 로그인합니다.

파일

Related MCP server: Synapse

빠른 시작

npm install
cp .env.example .env      # set PUBLIC_URL and AJEMS_HOST_TEMPLATE
npm start

실제 워크스페이스로 검증:

node diagnose.js https://mcp.ajems.com <organisation> <secret-key>

또는 AJEMS 없이 시도:

npm run mock              # terminal 1
# set AJEMS_HOST_TEMPLATE=http://localhost:9090/{org}/json_builder
npm start                 # terminal 2
node diagnose.js http://localhost:8080 testco test-secret-key

nginx, TLS, pm2 및 튜닝에 대해서는 DEPLOY.md를 참조하세요.

도구

기본적으로 읽기 전용입니다. 네 가지 쓰기 도구에 대해 ALLOW_WRITES=true를 설정하세요.

aggregate_responses는 서버에서 계산합니다. 이것이 없으면 "도시별 합계"는 수천 개의 행을 모델의 컨텍스트로 가져와 손으로 세어야 합니다 — 느리고, 비싸고, 일정 규모를 넘어서면 틀립니다.

search와 fetch가 존재하는 이유는 Developer Mode 밖에서 ChatGPT는 이 두 이름의 도구만 호출하고 나머지는 모두 무시하기 때문입니다.

질문이 답변되는 방식

Claude가 *"7월 항목이 도시별로 몇 개인가?"*라고 묻습니다:

1. list_apps_and_forms → 폼을 찾습니다

2. describe_form → date_1750943312417이 날짜 필드이고 dropdown_1750943301432가 도시를 담고 있음을 알게 됩니다

3. 날짜 범위와 group_by로 aggregate_responses → 세 개의 숫자를 돌려받습니다

4. 평이한 영어로 답을 작성합니다

필드 키는 자동 생성되므로(date_1750943312417) 2단계는 선택 사항이 아닙니다. 도구 설명이 모델에게 이를 알려주고, 모델이 스스로 호출을 연결합니다.

테넌트 격리

• 테넌트는 세션에서 오며, 베어러 토큰에서 서버 측에서 확인됩니다

• 어떤 도구 스키마에도 tenant, org 또는 url 매개변수가 없습니다 — 모델이 변경하도록 유도될 수 있는 것이 없습니다

• ajems.js는 아웃바운드 요청을 발행하는 유일한 모듈이며, 해당 테넌트의 기본 URL에만 요청합니다

• 캐시 키는 테넌트 및 비밀 키의 해시로 네임스페이스가 지정되므로, 테넌트는 서로의 캐시 항목을 읽을 수 없고 회전된 키는 자동으로 만료됩니다

• 조직 이름은 서브도메인에 안전한 문자로 축소되므로, evil.com/x 같은 항목이 서버를 다른 곳으로 리디렉션할 수 없습니다

• 모든 도구 호출은 테넌트와 사용자와 함께 JSON으로 기록됩니다

도구를 추가할 때 두 번째 항목을 다시 확인하세요.

테스트

목(mock)에 대해 46개의 검사가 통과합니다: 인증, 10개 도구 전체, 필터, 날짜 범위, created_at 폴백, 그룹화된 집계, 대량 삽입, 쓰기 후 캐시 무효화, 오류 메시지, 테넌트 격리, 20명의 동시 사용자, 속도 제한.