Port MCP Server

포트 MCP 서버

Port.io API를 위한 MCP(Model Context Protocol) 서버는 Claude가 자연어를 사용하여 Port.io의 개발자 플랫폼 기능과 상호 작용할 수 있도록 해줍니다.

Port MCP로 할 수 있는 일

자연어를 사용하여 Port.io 작업 방식을 혁신하세요.

정보를 빠르게 찾으세요

• 엔터티 세부 정보 가져오기 - "서비스 X의 소유자는 누구입니까?"
• 당직 상태 확인 - "지금 당직 중인 사람은 누구입니까?"
• 카탈로그 통찰력 얻기 - "현재 운영 중인 서비스는 몇 개인가요?"

스코어카드 분석

• 약점 파악 - "골드 레벨에서 어떤 서비스가 실패하고 있으며, 그 이유는 무엇인가?"
• 규정 준수 상태 가져오기 - "보안 요구 사항을 충족하지 못하는 모든 서비스 표시"
• 품질 개선 - "다음 점수카드 레벨에 도달하려면 무엇을 수정해야 합니까?"

리소스 만들기

• 점수표 작성 - "기본, 실버, 골드 레벨로 '보안 태세'라는 이름의 새 점수표를 만듭니다."
• 규칙 정의 - "실버 레벨에 도달하려면 서비스에 팀 소유자가 있어야 한다는 규칙을 추가합니다."
• 품질 게이트 설정 - "서비스에 적절한 문서가 있는지 확인하는 규칙 만들기"

저희는 Port MCP의 기능을 지속적으로 확장하고 있습니다. 제안하실 사항이 있으신가요? 로드맵 에 대한 여러분의 의견을 기다립니다!

설치

포트 자격 증명을 얻으세요

1. Port.io 계정 만들기:
   • Port.io를 방문하세요
   • 계정이 없으면 가입하세요
2. API 키 생성:
   • Port.io 대시보드로 이동하세요
   • 설정 > 자격 증명으로 이동하세요
   • 클라이언트 ID와 클라이언트 비밀번호를 모두 저장하세요

클로드 데스크탑

claude_desktop_config.json 에 다음을 추가하세요.

도커

지엑스피1

커서

커서 설정에서 구성:

• 커서 설정 > MCP 서버로 이동
• 다음으로 구성:
  • 이름 - Port
  • 유형 - Command
  • 명령어 - /path/to/your/file/run-port-mcp.sh

####도커

사용 가능한 도구

청사진 도구

1. get_blueprints
   • Port에서 모든 청사진 목록을 검색합니다.
   • 선택 입력 사항:
     • detailed (부울, 기본값: false): 각 청사진에 대한 전체 스키마 세부 정보를 반환합니다.
   • 반환: 사용 가능한 모든 청사진의 형식화된 텍스트 표현
2. get_blueprint
   • 식별자를 사용하여 특정 청사진에 대한 정보를 검색합니다.
   • 필수 입력 사항:
     • blueprint_identifier (문자열): 검색할 청사진의 고유 식별자
   • 선택 입력 사항:
     • detailed (부울, 기본값: true): 전체 스키마 세부 정보를 반환합니다.
3. create_blueprint
   • 포트에 새로운 청사진을 만듭니다
   • 필수 입력 사항:
     • 식별자, 제목, 속성 등을 포함한 다양한 필드
   • 반환: 생성된 청사진 객체
4. update_blueprint
   • 기존 청사진 업데이트
   • 필수 입력 사항:
     • identifier (문자열): 업데이트할 청사진의 고유 식별자
     • 업데이트할 다양한 필드
   • 반환: 업데이트된 청사진 객체
5. delete_blueprint
   • 포트에서 청사진 삭제
   • 필수 입력 사항:
     • blueprint_identifier (문자열): 삭제할 청사진의 고유 식별자
   • 반환: 성공 상태

엔티티 도구

1. get_entities
   • 주어진 청사진에 대한 모든 엔터티를 검색합니다.
   • 필수 입력 사항:
     • blueprint_identifier (문자열): 엔티티를 가져올 청사진의 식별자
   • 선택 입력 사항:
     • detailed (부울, 기본값: false): 속성을 포함한 전체 엔터티 세부 정보를 반환합니다.
2. get_entity
   • 특정 엔터티에 대한 정보 검색
   • 필수 입력 사항:
     • blueprint_identifier (문자열): 엔티티가 속한 청사진의 식별자
     • entity_identifier (문자열): 검색할 엔터티의 고유 식별자
   • 선택 입력 사항:
     • detailed (부울, 기본값: true): 전체 엔터티 세부 정보를 반환합니다.
3. create_entity
   • 특정 청사진에 대한 새 엔터티 만들기
   • 필수 입력 사항:
     • blueprint_identifier (문자열): 엔터티를 생성할 청사진의 식별자
     • entity (객체): 블루프린트 스키마를 따르는 엔티티 데이터
4. update_entity
   • 기존 엔터티 업데이트
   • 필수 입력 사항:
     • blueprint_identifier (문자열): 엔티티가 속한 청사진의 식별자
     • entity_identifier (문자열): 업데이트할 엔터티의 고유 식별자
     • entity (객체): 업데이트된 엔티티 데이터
5. delete_entity
   • 엔터티 삭제
   • 필수 입력 사항:
     • blueprint_identifier (문자열): 엔티티가 속한 청사진의 식별자
     • entity_identifier (문자열): 삭제할 엔터티의 고유 식별자
   • 선택 입력 사항:
     • delete_dependents (부울, 기본값: false): true인 경우 모든 종속성도 삭제합니다.

스코어카드 도구

1. get_scorecards
   • Port에서 모든 점수카드 검색
   • 선택 입력 사항:
     • detailed (부울, 기본값: false): 전체 스코어카드 세부 정보를 반환합니다.
2. get_scorecard
   • 식별자를 통해 특정 스코어카드에 대한 정보를 검색합니다.
   • 필수 입력 사항:
     • scorecard_id (문자열): 검색할 스코어카드의 고유 식별자
     • blueprint_id (문자열, 선택 사항): 스코어카드가 속한 청사진의 식별자
3. create_scorecard
   • 특정 청사진에 대한 새로운 점수표 만들기
   • 필수 입력 사항:
     • blueprint_id (문자열): 스코어카드를 생성할 청사진의 식별자
     • identifier (문자열): 새 스코어카드의 고유 식별자
     • title (문자열): 스코어카드의 표시 제목
     • levels (목록): 스코어카드의 레벨 목록
   • 선택 입력 사항:
     • rules (목록): 스코어카드 규칙 목록
     • description (문자열): 스코어카드에 대한 설명
4. update_scorecard
   • 기존 스코어카드 업데이트
   • 필수 입력 사항:
     • blueprint_identifier (문자열): 스코어카드가 속한 청사진의 식별자
     • scorecard_identifier (문자열): 업데이트할 스코어카드의 고유 식별자
     • 업데이트할 다양한 필드(제목, 레벨, 규칙 등)
   • 반환: 업데이트된 스코어카드 객체
5. delete_scorecard
   • 포트에서 스코어카드 삭제
   • 필수 입력 사항:
     • blueprint_identifier (문자열): 스코어카드가 속한 청사진의 식별자
     • scorecard_identifier (문자열): 삭제할 스코어카드의 고유 식별자
   • 반환: 성공 상태

AI 에이전트 도구

1. invoke_ai_agent
   • 특정 프롬프트로 Port AI 에이전트를 호출합니다.
   • 필수 입력 사항:
     • prompt (문자열): AI 에이전트에 보낼 프롬프트
   • 반환: AI 에이전트의 호출 상태 및 메시지

피드백 및 로드맵

저희는 Port MCP를 지속적으로 개선하고 있으며, 여러분의 의견을 기다립니다! 로드맵 페이지 에서 피드백과 기능 요청을 공유해 주세요.

문제 해결

인증 오류가 발생하면 다음 사항을 확인하세요.

1. 귀하의 포트 자격 증명이 인수에 올바르게 설정되었습니다.
2. 필요한 권한이 있습니다
3. 자격 증명이 구성에 올바르게 복사되었습니다.

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 조건에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.