Field Control MCP Server

Claude를 Field Control 통합 API(https://developers.fieldcontrol.com.br/)에 연결하는 원격 MCP(Model Context Protocol) 서버로, Claude와의 대화에서 직접 고객, 서비스 오더, 협업자, 서비스 요청, 장비 등을 조회하고 생성할 수 있습니다.

제공하는 기능

Claude에서 사용할 수 있는 도구(tools):

Related MCP server: Jobber MCP Connector

1. Field Control API 키 얻기

1. 관리자로 Field Control 패널에 접속합니다.

2. 설정 > 개발자 설정으로 이동합니다(또는 직접: https://app.fieldcontrol.com.br/#/configuracoes/configuracao-para-desenvolvedores).

3. '통합 키'에서 새 키를 만들려면 클릭하고 이름을 지정한 다음 만들기를 클릭합니다.

4. 이 키를 저장하세요. 환경 변수 FIELD_CONTROL_API_KEY로 사용하게 됩니다.

2. 로컬에서 실행(선택 사항, 테스트용)

npm install
FIELD_CONTROL_API_KEY="sua-chave-aqui" npm start

서버는 http://localhost:3000에서 실행되며, MCP 엔드포인트는 POST /mcp입니다.

3. 서버를 인터넷에 배포(Claude가 접근하려면 필요)

Claude는 Anthropic 클라우드에서 연결되므로 서버는 HTTPS로 공개적으로 접근 가능해야 합니다. Node.js를 실행하는 모든 제공업체가 작동합니다. 무료 티어가 있는 두 가지 간단한 옵션은 다음과 같습니다.

옵션 A: Render.com

1. 이 프로젝트를 GitHub 저장소에 올립니다.

2. Render에서 저장소를 가리키는 Web Service를 만듭니다.

3. 빌드 명령: npm install — 시작 명령: npm start.

4. 'Environment'에서 FIELD_CONTROL_API_KEY 변수에 키를 추가합니다.

5. 배포 후 https://seu-app.onrender.com과 같은 URL을 얻게 됩니다. MCP 엔드포인트는 https://seu-app.onrender.com/mcp입니다.

옵션 B: Railway.app

1. 프로젝트를 GitHub에 올립니다.

2. Railway에서 'New Project' > 'Deploy from GitHub repo'를 선택합니다.

3. 환경 변수 FIELD_CONTROL_API_KEY를 추가합니다.

4. Railway는 npm start를 자동으로 감지하고 공개 URL을 노출합니다.

(다른 Node.js 호스트 — Fly.io, Vercel functions, Nginx를 사용한 자체 VPS 등 — 도 /mcp를 HTTPS로 노출하기만 하면 동일하게 작동합니다.)

4. 사용자 지정 커넥터로 Claude에 연결

1. Claude에서 설정 > 커넥터로 이동합니다.

2. **+**를 클릭한 다음 사용자 지정 커넥터 추가를 클릭합니다.

3. 서버 URL을 /mcp로 끝나는 형태로 붙여넣습니다(예: https://seu-app.onrender.com/mcp).

4. 이름을 지정하고(예: 'Field Control') 추가를 클릭합니다.

완료 — 다음 대화부터 Claude는 요청에 응답하는 데 도움이 될 때마다 서비스 오더, 고객, 협업자 등을 나열할 수 있습니다.

Team/Enterprise 요금제에서는 소유자가 먼저 조직 설정 > 커넥터 > 추가 > 사용자 지정 > 웹에서 커넥터를 활성화해야 합니다. 그런 다음 각 구성원이 자신의 계정을 연결합니다.

보안

• API 키는 서버에만 저장되며(환경 변수), Claude나 브라우저에 노출되지 않습니다.

• 기본적으로 이 서버를 사용하는 모든 사람은 동일한 API 키(환경 변수의 키)를 공유합니다. 이 커넥터를 서로 다른 키를 가진 여러 사람에게 제공하려면 src/server.js의 getApiKeyFromRequest()를 요청별 헤더에서 키를 읽도록 수정하고, 각 사용자가 커넥터의 '고급 설정'에서 이를 구성하도록 하세요.

• API 키를 저장소에 커밋하지 마세요. 항상 호스팅 제공업체의 환경 변수를 사용하세요.